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Perfection is the finest word processor available for any 
computer. We have received dozens of letters from 
happy users saying Just this... and all of these letters 
were unsolicited. "Superb" was used most often. 


Perfection manages to achieve all the sophistication of 
the most complex PC word processors while still using a 
user interface as friendly as Quill's. Perfection has a dual 
system of user control: menus while you are familiarising 
yourself with the program, and direct commands for the 
time when you feel ready for more adventurous things. 
The two systems can be used interchangeably and even 
simultaneously. Even more exciting — both systems are 
iterative. In case you don't understand what this means, 
let us give you an example: suppose you wished to move 
a block of text using the menus. You would choose Block 
Move (yes, it is right in the first menu) and the screen 
would then tell you to move your cursor to the start of 
the block. On most word processors you would have to 
navigate manually to this position: indeed, on many of 
them (Quill included) only a subset of the normal 
navigation commands would be available. On Perfection, 
not only can you use all the manual navigation 
commands (viz all 28 permutations of CTRL, ALT, SHIFT 
and the arrow keys!) but in addition you can use direct 
commands like GoTo Line or Page or any of eight 
markers. Even more amazingly, you can use Search 
(either as a direct command or from the menus) even 
though you are already ‘within' a menu option. 


Perfection has about 200 commands, but the layout of 
menus and the choice of keys for the direct commands 
makes it very easy to master. Though a 100+ page 
manual is provided (with all the important bits right at 
the front), you should only need to consult it for 
specialised operations like macros. 


Even If speed is not particularly important to you, we 
assure you that Perfection's lightning performance will 
enable you to use the word processor in sensible ways 
that you would not have dreamed possible before. For 
example, scrolling 100 pages or so is accomplished so 
quickly using the normal navigation commands that you 
do not need to bother using a menu option to do the 
move. Speilchecking, assuming you have Perfection Plus, 
Is accomplished virtually instantly: to spellcheck this 
whole ad (all the pages) would take under 1.5 seconds... 
Searching (you can switch case sensitivity, as well as 
equivalences between tabs, soft spaces and hard spaces) 
is at the rate of about 100 A4 pages per second. 


Moving from one word processor to another Is usually 
very traumatic. With Perfection, this will not be the case. 
Not only can Perfection read in Quill _doc and _exp files 
directly (you do not even need to tell it they are Quill 
files!) but it can make direct and immediate use of your 
existing Quill printer driver. File re-export is also possible. 


Perfection is truly WYSIWYG: this means that bold 
appears bold on screen, italics appear as italics, 
underlined as underlined, and so on. Of course, your 
printer may have functions we do not know about 
(upside down?). To deal with these, Perfection provides a 
number of on-screen shaded strips: these can be 
attached to any printer function you wish, and will not 
upset justification as a translate would. Of course, 
translates are provided as well! 


A variety of statistics on the document being processed 
are available: some of them are on view all the time, the 
rest can be toggled to instantly. Not only is there a word 
count, but also page, line, character and special 
character (like Superscript Off) counts. There are also a 
dozen status Indicators, letting you know whether you 
are in Insert or Overwrite mode, whether a block Is 
defined, whether interactive spelichecking Is enabled 
etc. Current line (from top as well as within page) and 
column positions and character codes are also available. 


A terrific feature of Perfection is the dual screen mode. 
You can view one part of the document while editing 
another. The sizes of the two windows are themselves 
adjustable, both in real-time or via the configurator. We 
should devote more space to the configurator: however, 
it must suffice to say that everything that could be 
dynamically set within Perfection may also be preset 
with the configurator. The configurator can, for 
example, allow you to select any of 256 colours for any 
of a dozen parameters (like paper colour, border colour, 
status window ink and paper colour etc). 


Perfection is fully multitasking without need for any 
external accessory: however, if you already use QPAC or 
Taskmaster or similar and are happy, you may go on 
doing so. 


There Is absolutely no way that we can prepare you for 
the quality ‘feel’ of Perfection. We have a great deal of 
experience using PC word processors costing many 
hundreds of pounds: with absolutely no exception, 
Perfection is far easier to use and master. 


So if you thought Perfection was unattainable, you have 
a very pleasant surprise coming to you! 





These programs accelerate QL operation by up to 10x (2x 
—4x Is typical) without having any adverse effect 
whatsoever on compatibility or anything else. Lightning 
SE is typically 40% faster than the standard version. This 
acceleration is totally independent of, and in addition to, 
any speed-up obtained by hardware means. So if you 
have Gold Card, your need for Lightning SE is just the 
same as if you had only an unexpanded QL - Lightning 
SE will accelerate both by the same ratio. 


The Lightning programs achieve their acceleration by 
automatically paging out sections of the QL's operating 
system and replacing these with optimal, concise code 
written by us. 


Lightning installation is a completely automatic and one- 
off: no knowledge of computing or programming is 
required. Once installed, Lightning can be completely 
forgotten about —- you will soon get used to the superb 
speed! Knob twiddlers are catered for too. 


Lightning technology Is not built in to any of our other 
programs. Perfection users (as well as users of all other 
QL software) should therefore use Lightning all the time. 


In summary: if you do not have Lightning, you are 
wrong. Buy this one ARST OF ALL! 


PROFESSIONAL PUBLISHER 


The Professional in Professional Publisher Is 
Professional Publisher supplied with a generous 
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Professional Publisher is by 
far the best DTP program 
for the QL. It Is fully com- 
patible with Perfection, 
Editor, Quill, Eye-Q & the 
ASCII editors. It allows you 
to both create and import 
both text and graphics. 
Text can be ‘poured’ into 
boxes of any shape , size 
and number, automatically 
maintaining justification 
and hyphenation settings. 
So flowing text around 
graphics is a doddle. 





much smoother effect. 

It is pointless for us to try 
to list all of Professional 
Publisher's features —- we 
would end up filling half 
the magazine! We will 
concentrate on just a few 
‘points’: Professional 
Publisher is extremely pre- 
cise, performing all its 
computations accurate to 
a small fraction of a mil- 
limetre. All its features can 
be preset by you using its 
configurator, ruling out 
the need for repetitive key 
strokes. 

The program is extraordi- 
narily versatile while re- 
maining Intuitive In its 
user interface. Buy it! 


PROFESSIONAL PUBLISHER 
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Toolbox | is an excellent collection of high definition 
fonts, clip art and utility programs for Professional 
Publisher. While the fonts supplied with Professional 
Publisher are excellent, many users will feel the need for 
a wider range of typefaces and styles. 


Toolbox Il starts where Toolbox | leaves off, providing an 
even better — and different — font collection. 


The two Toolboxes complement each other and are 
available together at a special price. 





FONT ENLARGER 
GRAFIX 


Font Enlarger does exactly what you would expect It to 
from its name. While Professional Publisher is also 
capable of enlarging fonts, it does them ‘on the fly' and 
consequently is not able to remove the jaggedness 
caused by magnification. Font Enlarger is much cleverer, 
and enhances detail without any step effect. 





While the built-in printer driver for Professional 
Publisher is excellent with 9-pin printers, it is not optimal 
with 24-pin or laser printers. Grafix is. 
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Eye-Q is the finest graphics program for the QL. While 
there may be other graphics programs with a few more 
features, no other program comes anywhere close to 
Eye-Q in sheer enjoyability. Eye-Q develops a pleasurable 
tactile relationship with you, and makes you feel like an 
artist (even if you aren't). Eye-Q graphics can be read in 
by Professional Publisher, and the latter's pages can be 
exported to Eye-Q (using Toolbox |). Everything in Eye-Q 
is menu-driven and there is context-sensitive help. 


While Eye-Q has Its own printer driver, Ultraprint allows 
you 22 distinct styles/sizes of printer output. The 
reasoning is that the scale of gradation suitable for 
pictures is probably unsuitable for text or line drawings. 


PC CONQUEROR 
SOLUTION 


PC Conqueror makes your QL into a PC-compatible 
machine,automatically. It does this by software means 
only, so there are no screws to undo or wires to fiddle 
with. Your QL stays a QL too. 


Why, might you ask, should you wish to make your QL 
into a PC-compatible? The reason is simple: you may wish 
to run the same programs at home as you do at work. 
Alternatively, you may wish to tap into the vast 
storehouse of PC software of every type and description 
you could imagine. 


Using PC Conqueror could not be easier. Just boot up your 
machine with the PC Conqueror disk In floppy 1 and 
within 10 seconds your QL will be transformed into a PC 
that is just waiting to be switched on. From this point on 
you will do exactly the same as you would if you were 
running a ‘real’ PC — this means putting a DOS disk (any 
version) into one of your drives and pressing a key. If you 
do not already have legal access to a copy of DOS, we can 
provide you with one at reasonable cost (see our price 
list). 


PC Conqueror runs as fast as it is possible for a PC 
emulator to run: we have used all our ‘skills to make it 
work quickly. Of course, you can make the emulation 
must faster by using Gold Card and Lightning SE. With 
this combination, you should get speed noticeably better 
than that of a PC XT... 


PC Conqueror allows you to fine-tune the operating 
environment of the PC in order to improve performance. 
If you get a hard disk or other high capacity floppy 
system, you can utilise part or all of it as a PC hard disk. 


PC Conqueror occupies under 80K and leaves 667K free 
for DOS when run on a Trump Card. This is more than you 
will get on a ‘real’ PC. 


Solution does what Conqueror does but Is about half as 
fast and is not quite as compatible. 





SPELLCHECKER 
MEGA DICTIONARY 


Spelichecker is what makes Perfection into Perfection 
Plus. We have made it available as a separate item for two 
reasons: (a) to allow Perfection owners to add it later 
(b) to allow users of other word processors to benefit 
from the very best in spelichecking technology. 


Spelichecker is supplied complete with three dictionaries 
of differing sizes as well as a system for building, 
reviewing and maintaining user dictionaries. 


Spelichecker's ultimate accessory Is the Mega Dictionary, 
which gives the user a vocabulary of over 350,000 words! 


3D PRECISION CAD SYSTEM 


This program allows you to manipulate shapes and 
figures In 2D and 3D at a speed that will leave you 
breathless. Irrespective of whether your interest is in CAD, 
in animation or in just having fun, this program should 
not be missed. You can output to plotters directly from It, 
or alternatively create graphics screens to be manipulated 
and output by Eye-Q, Ultraprint or Professional Publisher. 


SUPER SPRITE GENERATOR 


SSG moves things about the screen very fast and very 
smoothly, without flicker. Sprites can have up to 16 frames. 
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“a, TROUBLESHOOTER @ Bryan Davies focusses on letters this month 
iby SOFTWARE FILE @ QL Genealogist 

iv) QL SCENE @ Bio-powered QL? 

OPEN CHANNEL @ On the move 

QL SCENE @ Euro distribution for Digitiser 

HITTING THE GOLD @ Meet Miracle Systems 
SOFTWARE FILE @ Picture Master Plus 

HALF ALAPTOP @ A new use for the Z88 

THE NEW USER GUIDE @ DIM TO ED #chan 
SOFTWARE FILE @ Filemaster 

THREE IN THE HAND @ Three famous wordprocessors 
DIY TOOLKIT @ Four functions and two ideas 

(0) SOFTWARE FILE @ DEA and DISA assemblers 
SOFTWARE FILE @ Remind Me 


| 44 SYSTEMATIC MACHINE CODE PROGRAMMING @ Part 6 
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NEXT 
MONTH 


We have reviews of 3D Terrain, 
Polytext, Quickdisk and MasterBasic 
lined up, and also the long-awaited 
review of the GOLD CARD by Mike 
Lloyd. Also another Archive Answers, 
and more on desktop publishing. 





s it’s the April issue, a suitably 
over-the-top suggestion seems 
appropriate. What about buying 
a colour copier? Too expensive, 
yes, but the rate at which prices are com- 
ing down suggests that we may be able to 
contemplate such exotica before too long. 
The one that caught my eye was from 
Brother, and costs £1,995 plus VAT. A 
year or so ago, you wouldn't have seen the 
like of it for five times the price. The same 
applies to colour printers, which are rap- 
idly coming down into ‘our’ range. Despite 
the way goods are advertised, buyers’ 
minds don’t usually work only on percent- 
ages; if something is reduced by 50%, 
from £10,000 to £5,000, you won't be 
rushing out to buy it, but what if a laser 
printer comes down 50% from £500 to 
£250? That may having you reaching for 
your wallet. Laser printers — the black- 
and-white type — have all but reached that 
price level now, and colour is not that far 
behind. 





Spending money 


The add-ons are what you spend your 
money on, not the computer. Whether you 
paid the original £399, or the subsequent 
£199 or less for your QL, the chances are 
that you will have spent more than that on 
the bits and pieces you’ve added to it 
since. Provided the software suppliers 
keep up with the times, you will still be able 
to retain the same ‘it doesn’t owe me a 
penny’ QL to produce the output for what- 
ever printer you buy in future. There’s a 
good chance you'll need a lot of memory 
and plenty of patience to get prints that 
look as good as the cover of this maga- 
zine, but the memory can at least be 
purchased. 

The WDEL command is one of my pet 
irritations atthe moment. If memory serves 
aright, the problems with this command 
are fairly recent phenomenon, and it is 
necessary to consider the possibility that 
hard disk, Gold Card, ED drives, and later 
rom versions of the extra commands, are 
involved in what is now happening. The 
command appears to work; it puts up the 
usual Y/N/Q/A? type of message, and 
goes away without murmur after the an- 
swer is given. The trouble is that a subse- 
quent DIR reveals that some or all of the 
‘deleted’ files are still on the disk. The 
erratic Last Line Recall function might 





Bryan Davies goes 
briefly over the top — 
and then settles 
down in his 
Troubleshooting 

hat. 


have been put down to a peculiarity of the 
JM rom, or the Trump Card, except that it 
works every bit as badly with aJS rom and 
Gold Card. Wouldn't it be nice if someone 
cleaned up the whole command set, and 
put it all in one disk package that doesn't 
require 50 KB to load and gives a consist- 
ent QL? 

Yet another removal of the hard disk 
allowed the Ice rom to be plugged into my 
system again. The ‘desktop’ interface may 
be lacking in some features, but it is still 
very useful, and straightforward to use. 
Years ago, | went to much trouble to create 
icon macros with the Icicle program, to 
simplify preparation of my accounts, and 
they served me well until the enforced 
removal of lce made them unavailable. It’s 
good to have them back but, like so many 
of our better tools, Ice is not properly 
compatible with other things that have a 
good claim to be fitted. 


Readers’ letters 


Noel Mortier reports having received 
from TK Computerware the cartridges 
that were the subject of correspondence 
some months ago. The difficulty H.F. 
Banks had with running two pairs of drives, 
with different densities, off Trump Card 
and Gold Card appears to have been 
partially solved, and he should by now 
have upgraded his system to ED drives 
from Miracle Systems. He may not be 
alone in deciding that the fitting of upgrade 
rom chips is something best left to experts, 
especially when one is getting on in years. 
From correspondence, it would seem that 
quite a few QL users are drawing their 
pensions; a lot more are likely to be in the 
age group at which you suddenly realise 
that a pension is looming close! 

Back on the Serial 8056 again, PJ Hud- 





son is the latest user to suggest a way 
around the problem of obtaining paper for 
this printer. He has been using fax paper 
for three years and says it works fine in 
the 8056. The supplier he suggests (see 
INFORMATION below) can provide 30, 
50 and 100 metre lengths in both 210 and 
216 mm widths, at prices ranging from 
£2.93 for a 30 m roll of 210 or 216 mm 
width, to £42.23 for 10 rolls of 100 m 
length at 210 mm width. These prices 
include VAT but not post and packing. 
Presumably, the paper does not come on 
the same size roll that the 8056 uses, as 
Mr Hudson retains his old rolls and re- 
winds new paper onto them. 


Roland Piano 


Norman Foster enquired if we have 
any expertise on the subject of connect- 
ing a Roland electronic piano to the QL, 
via a MIDI interface. My own knowledge 
in this area is zero — has anyone done 
this? His other request was for comment 
on the advisability of replacing a Trump 
Card with a Gold Card. Money has to be 
the major factor for most of us, but there 
is a decent trade-in allowance for users 
who currently have a Trump Card. My 
experience with a Gold Card leaves mein 
no doubt that it is a desirable upgrade; of 
its various advantages, speed is the one 
that strikes you first, and most strongly. 
Programs which were never noted for 
their speed become quite nippy; I’ve just 
been running the Conqueror emulator 
and using the PC wordprocessor 
WordPerfect 5.0 and have been agree- 
ably surprised not to have to wait for my 
typed words to appear on the screen. 
More to the point for most users, Quill 
handles even large documents in an ac- 
ceptably fast manner, the cursor moving 
at a sensible speed and the Copy com- 
mand working well (unless you ask it to 
make acopy 50-100 pages away!). The 2 
MB of ram will cover most users’ needs 
until retirement. 


Archive loss 


Inthe January issue, J Paul Bissonette 
described his loss of Archive files, appar- 
ently through a bad floppy disk. You can't 
diagnose faults such as this atlong range, 
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but it strikes me that a faulty disk is not the 
place to look for such troubles. There are 
reasons for disks themselves going bad — 
rough handling and consequent mechani- 
cal damage (including the pouring of cof- 
fee into them!), exposure to excessive 
heat, being placed in close proximity to 


strong magnetic fields, physical impact of © 


the read/write head on the disk surface, 
etc. The user would normally be aware of 
such things, though, and would experi- 
ence trouble with other disks that had 
been treated the same way. 

The fact that one ‘bad’ disk didn’t appear 
to have any bad sectors when formatted 
on another computer and drive, looks at 
first sight to absolve it from blame, but it 
was not clear from the letter whether or not 
the same disk subsequently showed bad 
sectors when checked in the same drive 
after not being used at all for some days, 
or whether it behaved badly when used 
again in the same QL drive. My own expe- 
rience with close to a thousand floppy 
disks of both various sizes and formats, 
over more than five years, is that errors are 
exceedingly rare when disks are treated 
reasonably, and are quite obvious from 
the first time a disk is used; for example, a 
bad disk may fail to be formatted to 
the full number of sectors straight off (it 
may subsequently format correctly, but 
not consistently). If a commercially sup- 
plied program disk is bad, errors are fairly 
sure to show up as soon as programs are 
run. 


Format fails 


When a format operation on a floppy fails 
once, the disk may still be usable. Failure 
of the format operation more than once 
should be taken as a sign that the disk is 
not safe for valuable files, assuming that 
you are sure there is no problem with the 
drive. If more than one disk cannot be 
formatted correctly in the same drive, the 
chances are that the problem lies with the 
drive. With hard disk drives, the situation is 
essentially the same, although there are 
differences arising from the difference in 
working conditions. Physical or magnetic 
damage to a hard disk is unlikely, because 
of its sealed construction and secure loca- 
tion within a computer. You can, however, 
do damage to the magnetic platters and/or 
read/write heads inside a hard drive by 
treating the computer to a large shock, 
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such as being dropped on the floor. You 
are fairly certain to find out as soon as you 
use the computer and drive afterwards, 
though. Bad sectors are not at all uncom- 
mon on hard disks — from the specimens 
in my collection, trouble from bad sectors 
is very much more common with hard disk 
than with floppies, and it is essential to 
have a utility program which checks for, 
and marks, bad disk areas. The QL is 
poorly served in this respect; it is not easy 
to identify, or mark, bad areas on floppies 
or hard disks. If Mr Bissonette is still hav- 
ing disk problems after all these months, 
maybe he would care to send a sample 
disk for examination here? 





In that same issue of QL World, there 
was some comment about wordprocessing 
programs, in connection with Capt. Star- 
ling’s earlier comments about the Perfec- 





tioninstruction manual. As ageneral point, 
it should be said that even DP’s extensive 
manuals are diminutive compared to PC 
manuals, and the user should be grateful 
for that. Better a smaller manual that one 
actually reads all the way through, than an 
exhaustive one that never, ever gets read 
fully. Having said that, | must add that 
there were various items in the Perfection 
manual which | found difficult to find at first, 
but some changes have been made to the 
manual since that time. A much-needed 
index has been added. 


Reformatting 


On the subject of reformatting text, it 
seems we are in a very subjective area, 
and my own experience is that the Quill 
procedure of automatically reformatting 
text ‘as it goes’ is the norm, rather than the 
exception. We have to talk about other 
computers as well as the QL here, other- 
wise there are only three programs to 
compare — Quill, text’ and Perfection. 
Quill performs normal, full reformatting 
actions, when you insert additional text 
into existing text, and when you alter mar- 
gin settings. Itis strange, in that it will allow 
you to go back and change left and right 
margins for a single paragraph but any 
change of indent margin affects subse- 
quent paragraphs also. Text®’ reformats 
fully when insertions are made, but is less 
certain about what to do with changes of 
margin; changes take full effect from the 
point at which they are made, and it imple- 
ments left margin changes fully in existing 
text also, but it doesn’t always do the same 
with right margin changes. The Reformat 
command has to be used to make sure 
changes have been implemented com- 
pletely. 


Perfection 


Perfection also leaves you rather unsure 
of what has changed, as you can insert 
some text and have it reformatted, but not 
always completely; with changes of mar- 
gins, they are fully implemented from the 
point at which they are made — for new text 
— but have no effect on text before the 
cursor (this was also normal PC behav- 
iour) or on existing text if the cursor has 
been moved back before the changes are 
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made. Again, you need to use the 
Reformat command to make sure changes 
take effect everywhere. What puzzles me 
is the reason for making reformatting a 
non-automatic operation. This has never 
seemed to be something that is ever 
required of a WP program, even as an 
option, let alone as standard procedure. 
Presumably it comes from the world of 
programming. 









QL in Italy 











As mentioned in aprevious issue, Qltaly 
is an Italian QL user group, and two disks 
containing issues of their regular maga- 
zine were sent to me some while back. 
Looking at the contents of these disks 
was by no means a five-minute job and 
comment has had to wait until now. The 
magazine is very well prepared, profes- 
sionally presented, and contains a lot of 
information. One issue was devoted to 
QRam/QPac and related software, cov- 
ering the work of Tony Tebby and 
Jonathan Oakley at QJump, and the later 
developments from (mainly German) soft- 
ware writers/suppliers such as Jochen 
Merz, and the brothers can der Auwera. 
The opening screens of these disks are 
illustrated here. There are ahost of screen 



















QD II = The first (and only) Editor using the Pointer Environment. £38 
(XE Menu - the Menu Extension NOW IN VERSION 3! QMenu is a very easy to 


use interface with pre-defined menus (e.g. file-select, simple-choice boxes, select from 
lists), These menus may be used from SuperBASIC, machine code and other languages. 
File-select, directory-select and list-select all re-written with more options, multi-columns 
etc. £12.90 Update from previous version with new manual £5 
FiFi - the FileFinder Fifi is easy to use and extremely useful. FiFi scans devices or 
directory trees and searches files or filenames for strings. Combinations are possible, e.g. 
String 1 AND String 2 BUT NOT String 3 etc. £16 


DISA - Intelligent Disassembler which allows you to disassemble interactively 
any kind of machine-code. Generates ASCll-output which may be assembled using the 
GST (Macro) Assembler. £29 


QDOS Reference Manual - This book is a must for all m-code pe rammers. It 
explains how to use QDOS, all traps and vectors, the Thing System, the HOTKEY System 
ll and much more. It points out which features work on a els an Emulator, how to write 
compatible for future operating systems. 170 pages. £30 


QPTR - The Pointer Environment Toolkit Revised manual which describes 
how to use the Pointer Interface and the Window Manager from SuperBASIC and 
machine-code. QPTR comes with examples on disc, keys, macros and extensions for 


SuperBASIC. £30 


FLP/RAM Level 2 now with ATR!!! Replacement EPROM for SuperQBoards 
(V1.17 onwards, with & without mouse) or TrumpCard (please eo ew Manual! 
Real sub-directories! QL-Emulator compatible! About twice as fast, with improved slave- 
block-handling! £18 


EASYPTR Ill - Create your own Pointer-Env. menus & sprites, use them in your own 
SuperBASIC or machine-code programs. Supports all the PE facilities, even split 
application sub-windows and uses the Menu Extension! Many examples an better 
manual! £4 


BX SYSTEM - System Tools for QDOS: real file-attributes are added, °9. write-only, 

‘dden or for selected users only. Works even over net and on winchester. New TRAP#3. 

New devices (equiv. to QL-Emu.): named pipes, MEM, NUL 80 new procs & features, e.g. 
WSET_FATTR, WSET_FTYPE, WSET_FVERS, ADIR, ASTAT, HK GETBES £27.50 
































files, showing aspects of the Pointer Envi- 
ronment software, and plenty of text files 
giving information on it. There is no need 
to fiddle about to see what is of interest — 
the boot file takes even an inexperienced 































user by the hand, through all that is on the 
disk. Obviously, plenty of thought has 
gone into the little details that can mar 
such an effort if not attended to. 

It requires considerable enthusiasm to 
sustain any magazine for more than afew 
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months. The presentation of the Qltaly 
magazine is very good. What is surprising 
is that this particular magazine has sur- 
vived 19 (maybe more, by now) issues, 
over a period of 3 years, and is still going 
strong so far as | know. Congratulations to 
Qltaly! 
















New text °” 






As of early February, the copy of version 
4 of text ®” promised several months ago 
has not materialised and one has to as- 
sume that some of the upgraded features 
in the program are taking much longer to 
implement than expected. In addition, the 
programmer himself had a bug for some 
weeks after Christmas! While nobody is 
happy with delays, they are by no means 
unusual with software. Trying to match 
added features in competitive programs, 
and cater for new hardware (eg GC and 
ED drives, hard disk), must be a wearing 
job. 











INFORMATION 
Serial 8056 FAX paper: 


“Office World”, address unknown, but 
branches in Nottingham, Leicester and 
Northampton. 
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QL-Emulator for ATARI ST 
(260, 520, 1040 and all Mega’s, but no STE’s). This hardware, together with software 
turns any ATARI into a QL. the emulator supports the standard MODE 4 as well as 
a MODE 4 in much higher resolution ee 
It supports real subdirectories (complete Level2 device drivers) on floppy, hard-disk 
and RAM-disc.. 
The complete QL emulator package includes a lot of utility software and extensions. 
if you are interested in an emulator, you should write for more information £166 
EPROM Cartridge for the QL-Emulator, switchable 
- with standard drivers £33 - with extended drivers £33 
Floppy adaptor to connect QL discdrives to the ST £9 
Mon for-cable ATARI to Scart £9 
Centronics-cable 2m £6.50 5m £10.50 


Games 
Diamonds £11 - BrainSmasher £12 - Arcanoid £10 
Firebirds £10 - SuperGamesPack £25 - QShang £14 
The Lonely Joker: 3 Patience games, many options, within one program 
(maybe you know it from Windows). It runs under the Pointer-Env. Very nice car 
pa te very addictive, keeps you busy for hours. £14.90 


Pack of 10 3.5" discs MF2DD £3.10 - MF2HD £5 


QSUP System Utility Pack £26 - Thing & Eprom Manager £18.50 

QDesign - Graphic-and Design-program (9 & 24 pin) £38 (Deskjet & Laserjet) £45 

- Font-Vector-Editor for QDesign £19 

DataDesign - Database program £55 

Please add £4.00 for postage and package (Europe) or £4 for 

one item and £2.50 for every further item (Overseas). All prices 

excl. V.A.T. E&OE. 
| | 


Access ) PE PENS i oy 
iS PN | MasterCard | op VISA 
|_suRDEARD.__ eS 


Cards welcome! No extra charge! 
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MEDIA MANAGER SPECIAL EDITION 
MEDIA MANAGER 


Media Manager Special Edition (MMSE) Is a program to 
be used both when things have gone wrong as well as 
when things are perfectly OK. It allows for automatic, 
semi-automatic and manual correction of a huge variety 
of disk and tape problems. It allows you to explore disks 
and tapes to your heart's content, producing all sorts of 
different diagnostic reports. MMSE Is very simple to 
operate, being menu-driven and assuming no degree of 
computer knowledge whatsoever. 


MMSE also allows you to tidy, catalogue, sort and order 
your disks and cartridges. 


The standard Media Manager is both less powerful and 
less user-friendly, but manages to work on an 


unexpanded QL. 


Both programs allow for data transfer between PC and 
QL. With MMSE, this transfer is at file and directory level, 
is bi-directional and is completely automatic. 


SPECIAL DESKTOP PUBLISHER 
DESKTOP PUBLISHER 


These programs are very primitive compared to 
Professional Publisher. However, if you have not 
experienced that program as yet, you will find both of 
these very competent. Both are capable of producing 
excellent results. The cheaper one has fewer features but 
is able to run on smaller systems. 





EDITOR SPECIAL EDITION 
THE EDITOR 


With the sole exception of Perfection, this is the best 
word handling system on the QL. Editor's features 
include an unrivalled degree of programmability and the 
ability to cope with the entire 256 character ASCII set. 
The Special Edition has enhanced document-type 
facilities, Including column blocks and on-screen page 


break displays. Neither program Is suitable for 
computing novices. Until Perfection, Editor Special 
Edition would have been our ‘Desert Island Program’. 


Editor SE can do a few things that Perfection can't, so 
the Ideal combination is to have both (they are 
compatible at file level and can multitask). If you order 
Editor SE at the same time as Perfection, you can have 
Editor SE at half price. 


PROFESSIONAL ASTROLOGER 


PROFESSIONAL ASTRONOMER 


The Astrologer program teaches you Astrology from 
scratch and enables you to automatically produce text 
narrative on personality delineation, year-to-year and 
minute-to-minute life predictions, compatibility 
interpretations and so on. Whether or not you believe in 
astrology — indeed, especially if you do not — this 
program Is one that you cannot afford to have. You can 
tailor the readouts (both In terms of quantity and what 
is sald) to your own particular requirements. The amount 
of fun you can have with this program Is endless. Do not 
blame us If you start believing in astrology, though! 








Astronomer Is an extremely fast and accurate solar 
system calculator, with planetarium views, planet faces, 
eclipses, cinerama display etc.. 





TURBO BASIC COMPILER 
SUPERCHARGE BASIC COMPILER 


Turbo Is the finest BASIC compiler for the QL and 
arguably the finest BASIC compiler for any computer! 





Turbo automatically converts working BASIC programs 
into optimised machine code, with no need for human 
Intervention. The benefits of this conversion are vastly 
enhanced running speed (as well as much faster loading, 
encryption and automatic bug fixing for a variety of QL 
interpreter oddities). Typical speed-up Is 20x - 100x. 


Turbo Is provided with a 200 command toolkit, adding 
many useful commands to BASIC. Most of these 
commands will be of immediate use to the programmer, 
whether he Is a novice or an expert. There are commands 
to load strings and floats into RAM, and to extract them 
automatically; to search memory and to move its 
contents; to control jobs and change their priorities... 


Supercharge has a few of Turbo's facilities and half its speed. 
















TOOLKIT Ill 


Toolkit lll starts where Toolkit H stopped, adding about 
60 new commands and enhandng many existing dual 
functions. Toolkit lil Is available either on disk or on 
ROM, and works whether or not you have Toolkit Il. 


Toolkit lll commands can, with only a couple of 
exceptions, be compiled using Turbo. 


QFLICK CARD INDEX 


All QL owners have a copy of Archive, supplied free with 
the QL. While Archive is competent, It is very hard to get 
to grips with and is not particularly fast. QFlick presents 
a very convenient alternative - a snappy , simple-to-use, 
pointer-controlled card file database. You can move data 
between QFlick and Archive In either direction. 


QFlick is not itself programmable but we document its 
data structure and give guidance on how to program it 
using Turbo. 


ARCHDEV + RTM 
DATABASE ANALYSER 
ARCHIVE TUTORIAL 
NAMES + ADDRESSES 
MAILMERGE 
DAT-APPOINT 
SEDIT 
SCREENPRINT 
RECOVER 


This suite of utilities will greatly enhance your use of the 
Archive database system. 






Archdev + RTM Is a straight replacement for Archive: it 
gives enhanced speed, greater workspace and a much 
cleaner boot-up. All your existing applications will work. 







Database Analyser provides very fast and comprehensive 
statistics about your Archive databases. 





Archive Tutorial proceeds systematically through the 
whole philosophy and grammar of Archive, providing 
you with expert and patient guidance. 






Names + addresses, Mailmerge and Dat-Appoint are 
ready-to-run, off-the-shelf Archive applications, 
providing an address database, mailmerging and 
appointment diary respectively. You now have no excuse 
not to use Archive. 












SEdit allows you to create and edit screen format files in 
Archive. Screenprint allows you to print them out. 






Recover allows you to get back lost Archive databases, 
created when you switched off the computer without 
properly exiting from Archive. 







XREF 
SUPERBASIC MONITOR 
BETTERBASIC EXPERT SYSTEM 


XRef analyses the structure of a BASIC program, 
providing detailed reports on things like variable usage, 
what calls what, dynamic call hierarchy of procedures 
and functions, and so on. 







SuperBasic monitor actually monitors and reports on the 
performance of BASIC programs as they run under the 
interpreter. : 













BetterBasic analyses and automatically corrects structural 
flaws In your programs and allows you to customise 
things like indentation, number of statements per line, 
filtering out of noise words, etc. 







The three programs together provide a matchless 
diagnostic and auto-correcting facility for BASIC 
programs. 


TRANSFER UTILITY 


This program copies files at high speed between devices, 
performing translates as it goes along. ideal for all sorts of 
applications, including transfers from microdrive to disk. 

















QMATHS SYSTEM 


This Is an Incredible mathematical compendium for the 
QL. Pride of place goes to the symbolic problem solver: 
this can solve equations, simplify expressions, factorise, 
expand, etc, all symbolically. If you could sneak this one 
into a maths examination, you would have a formidable 
ally. QMaths knows about all the algebraic operators, 
powers, roots, brackets, trigonometry, matrices, 
determinants, vectors, factorials, permutations, 
combinations, binomials, exponentials, logarithms, 
hyperbolics, inverse functions, infinite series including 
Taylor & Maclaurin expansions, complex numbers, 
conversions, Fourier series, and lots of calculus: both 
differential and integral, including integration by parts 
and definite integrals. QMaths optionally displays Its 
workings and comes with a superb interactive tutorial. 















The package also contains an interpretive, fractal, Image- 
generating language with loads of beautiful fractal 
programs supplied for you to use and edit - no 
programming skill is required. 







There Is also a multiple precision floating point maths 
package, giving calculations at precisions up to over 600 
decimal digits of accuracy. 







There Is even more to this system, but we think we have 
told you enough. 


QMON MACHINE CODE MONITOR 


The latest version of Tony Tebby's superb monitor: an 
absolute must for those who really want to know what 
is going on in the QL. No other machine code monitor 
even comes close. 














Do not confuse this program with SuperBasic monitor, 
which monitors SuperBasic, not machine code. 


COMPARE 


This program compares files - data or program - at 
colossal speed. Where a mismatch is detected, the 
relevant areas are highlighted and you can shuffle, 
displace and align very easily. 














CASH TRADER WITH ANALYSER 
PAYROLL 


Cash trader with Analyser is an accounts system designed 
by businessmen and not by wretched accountants! 
Consequently, it has excellent reporting and 
management facilities, and is very flexible. It Is almed 
primarily at the layman, probably a sole trader running a 
small or medium sized business. All the features you 
would expect — including audit trail - are present. 


Payroll Is a reasonably flexible system designed to 
automate the payroll function in small businesses. 


Both programs are configurable, with editable defaults 
letting you adapt the programs from year to year. 


HARDBACK WITH FINDER 


This is the ultimate hard disk backup and management 
utility, with all the sophisticated features you could 
want. User dialogue is via overlapping pop-up windows - 
the whole program just feels right. It is possible to scan 
the disk at great speed, too. 


PIR) Gpele] Ra int meleile qe hy ¢ 


This permits you to add password protection to disks, to 
optionally Increase disk storage capacity on DSDD drives 
by 36K and to increase speed of access by as much as 
30%, All this is done while maintaining full compatibility. 
Automatic file management is also provided. 














DIGITAL C SPECIAL EDITION 
DIGITAL C 


These are extremely fast and efficient C compilers, 
the Small C definition. 
rther, including support 


complying with and surpassin 
The Special Edition goes much 
for structures, pointers, long pointers, >64K code size, 
direct access to QDOS traps, etc. The Special Edition C 
generates code that runs about twice as fast as the other. 








PERFECTION DATA SHEET #2 


MENU 1 


SNUVOKSZCOMAODPADWAHAZHEY 


MENU 2 


MENU 3 


AMNHCMOMAZUVUAMPANZOWOWH FAGEZAOrANwBDVOMYSEe V!ADONOCH 


Load file 

Save file 

Merge file 
export block 
export flle 
Forward search 
Backward search 
Replace 

replace All 
Query the replace 
toggle Case Sensitivity 
Emphasise on 
emphasise Off 
Underlined on 
Not underlined 
moVe block 

copY block 
Delete block 
Print document 
Zap document 
eXit program 


Italic on 

sUperscript on 

subsCript on 

italic/superscript/subscript Off 

Highlight (=strip 2) on 

highlight oFf 

back to Normal (strip 1, standard font, no 
emphasised or underline) 

reformat pAra 

reformat from top of para hEreon 

forced (=hard) paGe break 

spell Pages 

spell Block 

Spell as you type 

Reinstate line containing cursor 

cycle end of Line space insert 

toggle auto line/word Wrap 

Margins 

Justification 

Tabs 


goto 
goto 
goto 
goto 


Top of document 

Bottom of document 
specified Line 

specified Page 

Goto pointer 

Mark pointer 

cycle laZy screen 

reveal hidden Codes 

special transpArent insert 

edit Header 

edit Footer 

load printer Data 

set start (initial) page Number 
Quote and edit page length 

undo current Emphasised region 
undo current Underlined region 
undo previous strIp change 

undo previous Superscript/subscript/italic change 


toggle Keeping of tabs on reformat 


THE INFORMATION PAGE 


active? * 
* normal eime-out. for 4 ra 
Sw ret MDIGITAL PRECISION :10 
set horizontal EF [] 


colour 
ns * set sizes 


on error? 
with scrolling 
k 
tio 
ht * 


* auto line-split 
dow paper 


to beep 
delay 


* main win 
colour * command win 


s repeat 
d 


keep pace 


* spellcheck 
colour * set default tab posi 


1 


startup? 


* attributes to 


set window width * set window heig 


* subsequent keypres 


dow background colour 
* command window backgroun 


rror ink 


te 


STATUS LINE INDICATORS/FLAGS (DEFAULT = 
COLumn number LINe number / 
visible CHARACTERS count 
total PAGES 
CAPS 


BLANK) 

total lines PAGe number 
hidden/control CHARACTERS count 
LINE number WITHIN PAGE 

CAPSlock on (Lower case) 

No line Wrap (Automatic line wrap at right margin) 
Centre/Right/Left Justification (Both L+R justification) 

OVerwrite (Insert) 

Case-Sensitive search/replace (Case-insensitive) 

search direction backwards (Forwards) 

No Querying of replaces (Query prior to replacing) 

a Block is Defined (No block currently defined) 

LaZy/Very Lazy i.e. accelerated screen-handling (Normal screen) 

Keep Tabs always (Replace TABS with spaces when reformatting) 
SPellchecking as-you-type (Spell-checking off, or by line/page/file) 
insert 0/1 Spaces in EOL region (Insert as many spaces as necessary) 


Character code 
WORDS count 


dow * centralise main window 
ves be freely altered within CONFIGURATOR AND FROM PERFECTION. 


ndow on 
delay 


case-sensitive? * search backwards? 
lazy attribu 


* main win 


NW 
CJ/RJ/LJ 
OV 


repeat 


cs 
UP ARROWS 


dow border colour 
lour * command window border co 
lour * command window e 


-out for 


ft page length 
lts may themsel 


fe) 
dow (full/top/bottom) * 


* display menu wi 


SPELLCHECKER COMMANDS (other than those already in PERFECTION) 

1 load 0/1/2 dictionary files (any combination of user and supplied) 
2 spellcheck a document file (Perfection or export) 

3 exit SPELLCHECKER 


te mode? * searching 
* initial keypress 


tive? 
* quick time 


of main win : 
dow * set vertical offset of win 


DICTIONARY UTILITY COMMANDS 

extract marked words from file/files/device, add to ASCII wordlist 
speedsort wordlist (removing duplicates), build user dictionary 
speedsort wordlist (removing duplicates) for editing in PERFECTION 
configure defaults for DICTIONARY UTILITY 

configure defaults for SPELLCHECKER 

exit DICTIONARY UTILITY 


tab-replace ac 
line length * so 
lour * main win 


Auf wre 
PERFECTION priority 


PERFECTION CONFIGURATOR COMMANDS - see sideways-printed list 
PERFECTION STRIPSORT COMMANDS - c20 options, no space for details 
PERFECTION PRINTER CONFIGURATOR - c50 options inc 16 big translates + 4 strips 


PERFECTION CONFIGURATOR OPTIONS (continued) 
* startup in overwri 

auto 

lazy attribute 

working 

window ink co 

colour * command window ink c 
command window error paper co 
and positions 

offset of win 

Note that these preset defau 


PERFECTION DATA SHEET #1 


STOP PRESS/PRODUCT INFO 


We are on the look-out for superb QL programs: our aim, to make them 
even better and then include them in our range. Write if interested. 


Please see the outside back cover for more information on PERFECTION 
and on other Digital Precision gear. Here's what PERFECTION does: 


DIRECT KEYPRESS COMMANDS 


Oe i Ri Rie Se aS Sie maine ae ie SS oe Le + 
| CTRL/ | CTRL/ALT/ 

wt------------------------------ tee n- ne ------- -------- -- =~ - - 

A cycle justification setting immediate replace All 

B goto Bottom of document Backward search 

C cycle job (QDOS) Copy predefined block 

D Define highlight as block Delete predefined block 

E Emphasised (bold) on Emphasised (bold) off 

F Forward search Footer edit 

G immediate search in direction | Goto line number 

H reveal Hidden codes Header edit 

I insert tab (QDOS) set Indent margin here 

J enter (QDOS) recall last entry (TK2) 

K insert hard=forced page break | export predefined block 

L Load file(native/Quill/export)| set Left margin here 

M Merge exported file Move predefined block 

N back to Normal (reset) spellcheck pages 

O italics/super/subscript Off spellcheck block 

P Print document to printer/file| goto Page number 

Q Quote / edit page length toggle Query before replace 

R Reformat this paragraph set Right margin here 

S Save file Spellcheck as you type 

T goto Top of document | set Tab positions 

U Underlined on Underlined off 

V set replace string set initial page number 

W put replace string here toggle word/line Wrap setting 

X immediate replace in direction| exit PERFECTION 

Y italics on toggle case sensitivity 

Z undefine current block Zap (i.e. clear) document 

a ---------------------------- ++ $---------------------- +--+ 

TAB insert TAB 

ENTER mark end of paragraph 

CTRL/ POUND special transparent insert 

CTRL/SHIFT/\ split very long lines 

CTRL/SHIFT/ ] cycle EOL space insert 

CTRL/SHIFT/ POUND cycle lazy screen 

CTRL/SHIFT/ESC wait for keypress 

ALT/CAPS communicate with SPELLCHECKER 

CTRL/CAPS communicate with PROPUB_INSERTER (picture inclusion) 

CTRL/ALT/CAPS load printer data 

SHIFT/CAPS reformat paragraph from here 

SHIFT/ALT/CAPS reformat hereon down through whole document 

CTRL/SHIFT/CAPS load macro from predefined block 

CTRL/SHIFT/ALT/CAPS export file 

CTRL/F1l remove the emphasis of this region 

CTRL/SHIFT/F1 undo previous italics/superscript/subscript change 

CTRL/F2 remove the underlining of this region 

CTRL/SHIFT/F2 undo previous strip change 

CTRL/F3 execute macro 

CTRL/SHIFT/F3 load macro file 

CTRL/F4 superscript on 

CTRL/SHIFT/F4 subscript on 

F5 clear previous command prompt 

CTRL/SHIFT/F5 display alternate status line 

SHIFT/TAB toggle keep/replace tabs 

SHIFT/ENTER undo changes to current line (reinstate) 

SHIFT/ALT/1-8 mark Pointer 1-8 

ALT/1-8 goto Pointer 1-8 

ALT/F1-F4 set strip 1-4 (l=normal, 2=highlight) 

SHIFT/ALT/+ set search direction to forward 

ALT/- set search direction to backward 


All other ALT keys available for customisation: use the MENU option where a 
direct PERFECTION keypress clashes with a non-configurable TASKMASTER key. 





























----- towne mn napa nnn npn sw pn nn nn np ese nn pe 
|SHIFT| CTRL |ALT |CTRL/SHIFT|SHIFT/ALT| CTRL/ALT | CTRL/SHIFT/ALT | 
----- Fer nte nme nnn nn pan nn penne enn nf nn pn gp ee 
UP | by | by |cursor| by |alter case|by screen| goto top | delete line 

/DOWN|line|para |static|page| of word depth for bottom |cursor up/down 
----- tert nr tn nm wn fw fan nn nf oo en nn po ep et 
RIGHT| by | by delete| to delete by screen|search abdaieh eioti to EOL 
/LEFT|char|word | char | EOL word width |highlight |right or left 
----- tem manta nn nn penn nnn pen nn pan ne nn pa nn nn pe ep 
INDIRECT (i.e. MENU) COMMANDS 
TOP (DEFAULT) MENU 

Fl Toggle Help 

F2 Toggle menu visibility 

F3 cycle menu 1-2-3-1 

F4 Refresh screen 

F5 Switch between windows 

SHIFT/F1 Re-perform last command 

SHIFT/F2 Toggle L/R menu visibility in Mode 8 

SHIFT/F3 cycle menu 3-2-1-3 

SHIFT/F4 Resize/move windows 

SHIFT/F5 Toggle Single/dual window mode 

ESC Cancel command, escape from sequence 


ALT/F5 Toggle Overwrite/Insert 


y || 


MDIGITAL PRECISION :10 


Le 


* Tab Positions * 
colour for 


Emphasised Ink Colour and 
action 0/1/S * startup 


and Device Names * Font 
printer data device and file name * curren 


y * 


Update PERFECTION? * ink 
end of line 
* current default font device name * 


p Priorities * File 
* Lazy Screen Parameters 


colour * default 
name 


* current 


* current default device and/or file 


and Margins * PERFECTION Job Priorit 
p 3 


to Lines * Baud Rate * Exit * 


Lengths * Autorepeat Delays 
light strip 2 colour * alter stri 


Screen Colours * PERFECTION Cleanu 
ication 


printer device or file name 


and Page 
* Action when Appending 


PERFECTION CONFIGURATOR OPTIONS (i.e. PRESET DEFAULTS) 


Screen Sizes and Positions * 


Names * Maximum Line 
Miscellaneous Parameters * Justif 


macro file name * current 
help device and file name 


Strip Colours 
emphasised * high 


CJ CJ 


pt 
or 


the superscript font * current name for the subscri 


current name for the standard font * current name. for 
font * current name for the italic font * minimum 


PERFECTION cleanup job * default 


priority for PERFECTION cleanu 


p job * maximum priority f 


nd mar 


gin * indent margin * 


hand margin * right ha 


* left 


ery lazy screen accele 


justification 





eee contd 


ration? * lazy screen acceleration factor .. 


suppress lazy screen? * suppress v 


169.95 eT PC CONQUEROR WITH DR-DOS v5.0 

a) od = PAN Be ) Y 129.95 dT PERFECTION PLUS WITH SPELL CHECKER 
119.95 eT THE SOLUTION WITH DR-DOS v5.0 
99.95 cT CPORT WITH C68K COMPILER 


5% off total if you buy 2 programs/upgrades; 


10% off 3; 15% off 4; 20% off 5; 25% off 6+ 23:39 cr Ce sanien v3.0 + ANALYSER 
\ no eae cost ae in pike cee oe 89.95 eT PC CONQUEROR 
on- urope add 5%, rest of wor 10% 89.95 cT PROFESSIONAL PUBLISHER 
For full terms and conditions, please refer to any of our OL World ads from Jan—-Nov 1990, or write in | ing a SAE 89.95 cT CPORT BASIC TO C TRANSLATION SYSTEM 





79.95 aT TURBO BASIC COMPILER + TOOLKIT 


69.95 aT PROFESSIONAL ASTROLOGER WITH ASTRONOMER 
e770) ame 74h) GO mem ae) ia ans: 59.95 cT QMATHS MATHEMATICAL SYSTEM 
59.95 aT PROFESSIONAL ASTROLOGER 
This program translates SuperBasic programs directly into C source code, automatically. 49.95 +aT LIGHTNING SPECIAL EDITION 
This C source code may then be edited or compiled. If you want to move programs to C 49.95 eT PROFESSIONAL PUBLISHER TOOLBOXES (PAIR) 
for migration to other hardware, or want to accelerate your programs, or just want to 49.95 eT ACT SPECIAL EDITION 
learn C the easy way (chuck BASIC in one end and examine the C that spews out of the 49.95 dT THE EDITOR SPECIAL EDITION 
other), CPort is the system for you. 49.95 dT SPELLCHECKER 
: 49.95 dT MEDIA MANAGER SPECIAL EDITION 
CPort Is friendly and tolerant of poorly written BASIC. There is even a method of dealing 
with unusual BASIC keywords. The deheratee C, which can be switched between the 49.95 dT 3-D PRECISION CAD SYSTEM 
ANSI and Lattice industry standards, is very readable and is often optimal. CPort's user 49.95 cT PAYROLL | 
interface Is extremely friendly. CPort is available with or without the C68 compiler. 49.95 cT HARDBACK + FINDER 
49.95 bT SUCCESS 
49.95 aT DIGITAL C SPECIAL EDITION 


ee 44.95 +a TOOLKIT IIT WITH ROM 
REORT ILER WI .95 eT SOLUTION 
SUPERFORTH COMP 39.95 dT IDIS SPECIAL EDITION 


Forth Is the most logical computer language. This compiler produces multitasking code. 39.95 ct SPECIAL DESKTOP PUBLISHER 

The manual teaches you Forth-83 from scratch. 39.95 at QMON MACHINE CODE MONITOR v2.05 
39.95 aT SUPERFORTH COMPILER WITH REVERSI 
39.95 aT EYE 


—Q 
34.95 d MICROBRIDGE 


IDIS SPECIAL EDITION 29.95 eT MEGA DICTIONARY 
IDIS 29.95 f£T PROFESSIONAL ASTRONOMER 
29.95 eT PROFESSIONAL PUBLISHER TOOLBOX 


These Intelligent disassemblers make the otherwise terrifyingly complex task of 29.95 eT PROFESSIONAL PUBLISHER TOOLBOX PART TWO 
understanding other people's machine code programs absurdly easy. The SE version, 29.95 a TOOLKIT III 
which has a higher hardware requirement, sorts out some routines, replaces addresses 29.95 a SUPER SPRITE GENERATOR 
with names, untangles data from code and much more. 29.95 a SUPERCHARGE SPECIAL EDITION 
29.95 a QFLICK CARD INDEX SYSTEM 
29.95 a PERFECT POINTER TOOLS 
29.95 a GAMES COMPENDIUM (ALL FIVE GAMES) 


QKICK FRONT END SYSTEM ogee Eee C ComPTLER 


29.95 aT XREF v2.0 
This is a simple, easy-to-master, pull-down menu controlled multitasking front end. QKick 29.95 aT SEDIT 


runs In the background and can be called up at any time. It provides you with notepads, 
sophisticated file/sector/RAM handling, backing up facilities, a clock, diary, calculator, 29.95 aT ARCHDEV + RUN-TIME MODULE 


mini-database and so on. 24.95 f SUPER ASTROLOGER 

24.95 d DESKTOP PUBLISHER 

24.95 a QKICK MULTITASKING SYSTEM 
24.95 a MEDIA MANAGER 


24.95 at IDIS INTELLIGENT DISASSEMBLER 
ADVENTURE CREATION TOOL SPECIAL EDITION 24°35 3% Shemste WON To 
ACT is a must for every programmer. The name of the program Is misleading, insofar as It -95 aT LIG N 
has capabilities far beyond the ‘mere’ creation of adventures. ACT has utilities providing 24.95 aT BETTER BASIC EXPERT SYSTEM 
animated graphics, data compression, language design, parsing, maps, object-oriented 19.95 eT FONT ENLARGER 
control etc. If all you want to do Is generate adventures, though, you do not need to be 19.95 dT NAMES AND ADDRESSES 
a programmer to use it. This Is a purchase you will never regret. 19.95 dT DAT—APPOINT 


19.95 b DISKTOOL WITH QUICKDISK 

19.95 aT ULTRAPRINT 

19.95 aT SCREENPRINT 

19.95 aT RECOVER 

19.95 aT PEDIT 

19.95 aT MAILMERGE 

19.95 aT DATABASE ANALYSER 
COMPARE 


19.95 aT ARCHIVE TUTORIAL 


9.95 f£ SUPER BACKGAMMON GAME 
ite te) :iiii ete) = 9.95 REVERSI GAME 








PEDIT 


A fast, modern and capable printer driver for the programs bundled with the QL. 






f 
9.95 f DROIDZONE GAME 
Superb contract bridge bidder (ACOL etc) and player, using millions of random but 
reconstructable hands Microbridge also Includes a ate of the art interactive bidding 9.95 f£ BLOCKLANDS GAME 
tutor and a clear Instruction manual. There Is nothing like this anywhere else! 9.95 f£ ARCADIA GAME 
9.95 eT GRAFIX 
9.95 b TRANSFER UTILITY 


x KEY: + As well as mdv disk, you get a ROM 
SUPER ASTROLOGER Available either on adv or disk 
Available only on disk 


A very cut-down version of Professional Astrologer - still great fun, though! Minimum 512K RAM:only available on disk 
Minimum 1.5M RAM:only available on disk 


Minimum 256K RAM:either mdv or disk 
SUCCESS CP/M EMULATOR T Compatible with THORs including XVI 


Minimum 256K RAM:only available on disk 
Allows your QL to run CP/M programs at great speed. t Compatible with all THORs except XVI 





Available only on adv 


OP RAO AO oS 






Send to: DIGITAL PRECISION LTD, 222 THE AVENUE, CHINGFORD, LONDON E4 9SE or phone 081-527 5493 
Eee Sa ee errr r—“‘“O=iC*CO“‘RRNRRR.ttCt 








PROPOR TT RES ER EEE ORO TE REET EERE THESE SEE SHE EE TEE EEE EE EEE TEESE TEETER EERE EEO REE TEE SEE SEEEEEEEE HED EES TEESE HEE EEO EEH HEH EET OTE SEE SEE EEE HER RED EET HER EEE EEE EES EEE HEE TOE EEEEHEHEH EEE EEE EEE SER ETH ETE SEE SEH EER HEHHHHESH ERE REDE EE 





De ae Postcode: = | 
Encl: CHEQUE/VISA/ACCESS/MASTERCARD/PO/MO/CASH forf ss AMOUIGITAL PRECISION :70 aii PRECISION ro 
crane, |. 8 ExXpify: signe? rc CL 









Delete as appropriate: (QL/THOR/STQL)(MDV/3.5"/5.25")(Disk=360/720/1440/2880/6400 sectors; nb 1 sector=0.5K)(If 720 sectors: SSDD/DSSD) 








BS FIWARE FILE 


John Shaw calls 


on his mightly 
ancestors. 





hen I was review- 
ing OL Genealogist 
in the January 
1991 edition of OL 
World I found myself almost 
running out of superlatives in 
my efforts to describe the pro- 
gram. Chris Boutal seemed to 
have created an almost perfect 
family research program. I 
could think of no other way in 
which it could be improved. 
Now, to my delight, a Second 
Edition has emerged, enhanc- 
ing one of the jewels in the QL's 
crown. 

I think that if I had created 
such a program, I might have 
rested on my laurels, but notso 
Chris. What has he done to 
improve the original QL Gene- 
alogist? The answer virtually 
fills 22 pages of an A4 updates 
manual. I can't detail every- 
thing, but I will describe some 
ofthemore important changes. 

One of the most important 
features of any complex pro- 
gramis the instruction manual. 
If this is difficult to understand, 
the whole thing becomes diffi- 
cult to use. Chris has taken great 
pains to make sure his manual 
is easy to follow, logical and 
helpful. Evena total newcomer 
to the OL or family history re- 
search will have little difficulty 
in becoming proficient. A step 
by step tutorial covers four 
pages and provides all that is 
needed to use every aspect of 
the program. 





Data safe 


Owners of the original QL 
Genealogist will be pleased to 
hear that their data needs no 
modification to work on the 
Second Edition. Chris, how- 
ever, warns that once SAVEd 
by the Second Edition, the files 
cannot be read again by the 
original version. 
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INFORMATION 
Program: QL Genealogist: 
Second Edition 
Supplier: Dilwyn Jones 
Computing, 
41 Bros Emrys 
Tal-y-Bont 
Bangor, Gwynedd 
QOL Genealogist: 
Second Edition 
£30.00 disk only; 
Budget 128K QL 
Genealogist £10.00 
disk £12.00 mdv; 
Upgrade Standard 
to Second Edition 
£12.00 disk only; 
Upgrade Budget 
to Second Edition 
£24.00 disk only; 
Translation service 
from Archive £6.00. 
Minimum 256K memory 
expansion required (except 
for 128K Budget edition). 
Runs on Minerva and 
Goldcard 


In the main menu, Spelling is 
now moved from Research so 
that it can be used in the Fam- 
ily Tree section. A Colours 
command allows you tochange 
screen colours according to 
your whim. Two new Export 
options are provided; All Tree 
data can now be exported to 
Abacus. 

Geography (new feature) 
data can be exported to Easel. 

In the Family Tree section, 
the author has made use of the 
five function keys to greater 
effect than before. <F1> is for 
cross reference, <F2> enters the 
Tree module, <F3> shows the 
menu, <F4> produces a 
hardcopy, <F5> enters the 
Notes module. 

New Commands include 
Markers, which allows you to 
‘mark' an individual in a 
number of ways and then use 
those marks to index, research, 
hardcopy and do many other 





manipulative actions. This is a 
very powerful new feature. 

Test is a most useful tool to 
enable you to check the integ- 
rity of your database. It checks 
for any anomaly within the tree 
structure. For example, it will 
highlighta person listed as both 
a mother and father or whether 
there is an unreasonable age 
gap between spouses. 

I wish this had been a feature 
of the first program. I recall 
that in my enthusiasm to input 
data with the First Edition, my 
father was alsoshown to be my 
uncle! The Second Edition eas- 
ily picked this error up, and it 
gave me 50 other warnings of 
possible errors. Most of these, 
fortunately, were just ancestors 
who had insufficient data en- 
tered against them. 

In the Research Data section, 
we have many improvements. 
You can Print in lines and col- 
umns, Link and Unlink events, 
and even provide yourself with 
statistical data. 

Full marks for the Geogra- 
phy facility. Now you can cre- 
ate and display amap showing 
the location of your ancestors. 
In addition, by using the 
Timespan function, you can 
step through time year by year 
to view the cumulative events 
in each place. 


The tutorial section, which 
now covers four pages, helps 
you understand the workings 
of the program by taking you 
step by step through each of 
the features. This section is ex- 
cellent and every minute spent 
following it will benefit the 
purchaser of the program one 
hundredfold. 

I have really only skimmed 
the surface of the new features 
provided by this program. As 
well as all the things I have 
mentioned, Chris has provided 
a Conversion Service in which 
he will try and convert your 
ARCHIVE _dbf files which you 
have created from the 
Microdrive Exchange Family 
Tree program into a format 
suitable for OL Genealogist. 


Easy use 


Chris Boutal is an enthusias- 
tic and accomplished family 
researcher. He is, however, 
sensitive to the needs of the 
complete beginner, so both his 
manualand programstructure 
permit the most nervous user 
to achieve success with the 
minimum of skill and effort. 

If you already possess the 
First Edition, then the upgrade 
is a must. If you have never 
looked into your family his- 
tory before, then do buy the 
program, even the cut down 
version for the 128 K QL is first 
class. 





ll 





WES CENE! 


Hands-on OL 


how 








NESQLUG (New England 
Sinclair QL User Group) will 
demonstrate at their April 
meeting anew extension called 
PROD, developed in collabo- 
ration with the Computation 
Genetics Corp of Michigan, 
USA. The new program uti- 
lises a breakthrough bio-ge- 
netic thermoplastic (BGTP) 
developed by CGC. 

The material has electrical 
conductivity properties which 
can be channelled to the comms 
(serial) port of acomputer. The 
PROD extension interprets 
signals froma sensor pad made 
from BGTP. In conjunction 
with the extension, this per- 
mits heuristic interpretation of 
the user’s needs when operat- 
ing other computer software. 

At a preview, CGC demon- 
strated how the user can oper- 
ate a number of unfamiliar soft- 
ware titles without reference 
to manuals, by placing one 
hand on the pad, exercising 
concentration, and applying 
Body English. Remarkably, in 
85% of attempts the user’s de- 
sired effects were input to the 
QL. More startlingly, the op- 
erator, ‘told that the pro- 
gram’s function was word 
processing, formatted three 
paragraphs of justified word- 
wrapped text in Abacus as 
quickly as if it had been Quill. 


Sweat 


The PROD extension cur- 
rently takes account of ten pa- 
rameters, including Sweat Sa- 
linity Factor, Body Language 
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uses 


biofeedback 


Profile Index, left or right 
handedness, and Personality 
type (A or B). 


Byron 


The CGC team is headed up 
by Arab-American computer 
high-achiever Dr R Ida bin 
Phulen, who is informally ac- 
knowledged to be descended 
from Victorian poet and all- 
round genius Lord Byron. 
“Initially, we selected the 
Sinclair OL because it was 
cheap,” Dr bin Phulen admits. 
“Subsequently, attempting to 
transfer the concept to differ- 
ent computers, we found that 
these results only occur on an 
unexpanded QL with a JSU 
rom. Our software team sus- 
pects that PROD utilises extra- 
neous code relating to the un- 
finished WHEN ERkRor func- 
tion on thatrom. Rumours that 
only a British computer can re- 
spond to Body English are pre- 
mature.” 

PROD will be released to the 
public domain as soon as the 
team are sure that the compu- 
ter will not retaliate if itis input 
at too high an EOR (emotional 
overload rate). “We see this 
development as a major break- 
through in Artificial Intelli- 
gence. Our sole interest is the 
commercial application of the 
sensor pad,” explained Dr bin 
Phulen. 

Itis expected that, when com- 
mercial release commences, the 
sensor pad will retail for about 
US$400. A rumour that a 29- 
cent sticking plaster works just 
as well is being discounted by 


German 
journal 


The Sinclair OL User Club eV 
has sent a copy of its German- 
language magazine, QUA- 
SAR. This is a stout, A4-size 
magazine of around 50 pages 
with a single-colour card 
cover, very well produced. 
For more information, write 
to Franz Herrmann, 
Talstrasse 21, W-5460 
Ockenfels, Germany. 


CGC. PROD and its source code 
willbe freely available through 
NESQLUG. 

Computation Genetics is ex- 
pected to receive commercial 
and military grants of US$75 
million to develop BGTP ap- 
plications on 1 April 1992. 


Plaster 


NESQLUG bulletin editor 
Peter R Hale was unavailable 
for comment. Colleagues be- 
lieve that he is in bed with one 


A bio-OL 
advances 
on a test 
user 
during 
trials. 
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Goldcard Test 
MOS-Card Test 
QTop Testbericht L@ 


ta aa 
sti bok! tec 
arm in sticking plaster after ac- 
cidentally asking his QL for a 
cup of black coffee and a steak 
sandwich, ‘well done’, while 
carrying out tests in the small 
hours of the morning. 

“We think the problem was,” 
said a representative, “that it 
was after the mall closed for 
the night.” Mr Hale is said to 
be “very surprised”, but in no 
danger. All enquiries at this 
stage should be sent to the New 
England Sinclair QL User 
Group, PO Box 8763, Boston, 
MA 02114, USA. 
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(PEN WHANNEL 


Open Channel is where you have the 
opportunity to voice your opinions in 
Sinclair QL World. Whether you want to ask 
for help with a technical problem, provide 


o 


somebody with the answer, or just sound off 
about something which bothers you, write 
to: Open Channel, Sinclair OL World, 
116/120 Goswell Road, London EC1V 7QD. 





Through your excellent maga- 
zine, I would like to thank 
reader Mr Frank West for sup- 
plying me with a copy of the 
8056 printer manual, as re- 
quested in Open Channel of the 
January 1992 issue. 
Anthony Landaw 
London NW9 


Editor’s comment: our thanks to 
Mr West also. 





Wethe members of the Quanta 
Lancashire Area Sub-group be- 
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lieve that the location notified 
for the forthcoming EGM 
(Raine, Essex) will prevent the 
majority of members from at- 
tending. While we recognise 
that it is too late to alter the 
location of the EGM, we feel 
most strongly that holding the 
AGM in a similar location 
would prevent the views of 
many members from being ex- 
pressed on a range of topics. 
It is healthy and fruitful to 
hold workshops at various lo- 
cations throughout the coun- 
try, but the AGM should be 
held in one which encourages 
and enables the maximum 
number of members to attend 
—close to the geographical cen- 
tre of the membership. Is this 





notsomewhere inthe Midlands 
ornear the north: Birmingham, 
Coventry, Manchester or Not- 
tingham? 

With Quanta’s positive cash 
balance, the cost of finding a 
suitable venue should not bea 
problem. 

The proxy system, too, wor- 
ries us; it is hardly democratic 
fora blank vote to be handed to 
a nominee, whether the chair- 
man or indeed any other 
Quanta member. For a mem- 
ber who wished to attend, but 
was prevented from doing so 
by distance, some facility for 
registering his vote is neces- 
sary, but there is no reason sim- 
ply to transfer his vote to any 
other person. 

On at least one recent occa- 
sion, the number of blank proxy 
votes given to the Chairman is 
believed to have been sufficient 
to swamp the votes cast by at- 
tending members. We believe 
this is not the wish of the mem- 
bership. 

Bill Barnet 

John Butterworth 
Mick Holland 
Steve Hutton 
Steve Johnson 
Peter Mangnall 
Roy Olive 

Mick Porter 
Keith Reader 

Joe Smith 

Mike Crossfield 
Quanta Lancashire Area 
Sub-group 


Editor's comment: This letter has 
also been sent by the Lancashire 
area subgroup to the Quanta com- 
mittee. The location of important 
meetings is often a matter for de- 
bate within organisations with no 
fixed headquarters. The location is 
then most often determined by the 
willingness of local members 
to organise the event. 

We have heard some interesting 
facts from the committee on this: 
they did a survey, and it turns out 
that the geographical centre of the 
UK in terms of Quanta member- 
ship is — wait for it — Luton. As it 


happens, Raine, where the SGM 
(that’s official) was held, is actu- 
ally on the same latitude as Luton, 
althoughona somewhat more east- 
erly longitude. They did try for 
Northampton, but couldn't find 
anywhere reasonably cheap at 
short notice. 

We have no definite news about 
where the AGM will be, but it 
seems pretty certain that it won't 
be Raine. Unless nobody else wants 
to organise it. . . 


Thavea problem with the char- 
acter sets for the various 
channels. In the June 1986 edi- 
tion of QL World, James Lucy 
wrote an article about this and 
mentioned addresses pointing 
to the start of the character 
fonts. HesaysthatintheJSrom 
this was 163960 and .. . 64. I 
know from various sources that 
in the AH rom it was 167722 
and...26.lused to havean AH 
rom, and when I wrote print 
peek_1 (167722) I got 41410 
(start of char$ block 32-127) or 
- with print peek_L (167726) -I 
got 42286 (start of char$ block 
128 - 255). Then I got a Medic 
memory expansion and the 
start address shifted to 177258 
and 177262 (still giving 41410 
and 42286); ladded something 
else, and the addresses shifted 
yet again, in jumps of 256 Kb to 
176682/176686, 177290/ 
177294, 177546/177550, 
177802 /177806. I presume that 
the addresses are different for 
the various channels, 0 for the 
input line and 1 and 2 for the 
screens. 

Right! I now find that some 
games such as Lock and Key, 
will ‘work’ on my daughter’s 
Medic QL using the address 
177290 in line 2390, but not on 
my Trump Card QL, using this 
number, nor on either of the 
new numbers which I’ve now 
determined by hunting 
through the rom for those 





13 


magic numbers 41410/42286. 
The relative addresses are now 
180778 /180782. | 

When I say that Lock and Key 
won't work, I mean that using 
address 180778 only gives me 
graphic char$ to channel 0 (in- 
put lines) and not onto the 
screen. So my screens are full 
of the %%$$E£:: char$ and are 
not being affected by the udg, 
program. 

I wonder if anyone there 
knows of a solution — in effect, 
how I can find out where the 
channel fonts are? In idiot lan- 
guage please! 

Dane Kurth 
Busswil 
Switzerland 


[pjenacepabatelcavel 


Disgrace! I shall have to give 
up QL World and subscribe to 
Tailor and Cutter instead! The 
button-hole of the jacket on 
your December issue is on the 
wrong side! Owzat for an ‘ex- 
tra Christmas present’? 
Happy New Year! 
Ron Mustoe 
Chester 


PS: Don’t worry, you haven't 
really lost a reader. Even if I 
don’t win the prize. Thanks for 
a regular good read. 


Editor’s comment: Yes, but it isn’t 
really a mistake: you see, our art- 
ist had to copy his own reflection 
in the mirror in order to capture 
the full beauty of his profile. And 
I think he’s made an extraordinar- 
ily good job of it, really, don’t you? 
The trouble is — as a result — he 
now has both eyes on the same side 
of his head, and has had to apply 
for a transfer from the Surrealists 
to the Impressionists. Whether that 
isa mistake must be left, think, to 
personal conscience. I prefer 
Botticelli myself. Happy New 
Year, but no banana. 


There has been quite a lot of 
talk recently about the replace- 
ment of the QL. A point that 
emerges is that of cost. I get the 
impression that there is an ex- 
pectation that any replacement 
will be a low-cost one, tending 
to establish the OL market as a 
low-end market more for hack- 
ers and enthusiasts than for 
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professional or business users. 

Similarly, the expectation is 
that software will also be low- 
cost, that is to say, that around 
£100 for professional or busi- 
ness-type software is excessive 
or at the very least an upper 
limit. 

I feel that if there is to bea real 
future for this market, users 
will have to realise that there is 
no such thing as a free lunch in 
computing. Good QL software 
isalready very cheap compared 
with other systems, and one 
cannot expect software writers 
and suppliers to operate un- 
less they can obtain some 
reasonable return for their ef- 
forts. 

Anyone who has tried the al- 
ternatives such as disk-bound 
DOS-based machines will 
know how inconvenient, slow 
and awkward they are in use, 
despite their glossy appear- 
ance, so I feel that those who 
want to ensure a future for our 
technology should accept that 
at the outset, at any rate, the 
price will have to be paid to 
maintain and expand this. 

Frank Gutteridge 
Corsier 
Switzerland 


Regarding P H Warne’s com- 
ments (Open Channel February 
1992) about my Abacus pro- 
gram for calculating building 
society income (OC October 
1991), either he has misinter- 
preted my meaning of ‘edit’ or 
Ihave beenas guilty as authors 
of some computer guides in 
leaving out steps in descrip- 
tions, assuming the reader was 
already one step ahead of me. 

The point arises where | 
wrote: ’... or one can go as far 
as March and then COPY the 
row March to get April...’ But 
the sentence continues *. . . ed- 
iting month-name and cell ref- 
erences where necessary.’ This 
referred to entering a long for- 
mula into one cell and 
COPYing it to other cells. 

Mr Warne is right in saying 
‘cell references in formulae are 
translated into relative 
positional references’ when 
COPIED in Abacus. Therefore, 
in this case, one has to edit 
them. Perhaps I should have 
taken ‘editing’ a step further in 
describing my program in the 
October 1991 issue. 





My method, once the row for 
March had been COPIED to 
get April, was: 

1) To AMEND the row for 
April by enclosing it in quote 
signs (“). Thus all subsequent 
COPYing would be of text. (It 
is helpful with long formulae 
to widen the columns tempo- 
rarily, so that all of the text is 
visible on the screen, rather 
than just see it in the edit win- 
dow of Abacus.) 

2) Once the rows in the grid 
had been filled in this fashion, 
I went back and used the 
AMEND command again, ed- 
iting month-name and cell ref- 
erences where necessary, and 
removing the quote signs from 
the cells where text was in- 
tended to be turned back into 
formulae again. 

With programs which havea 
lot of long-related formulae, I 
find this method less of a task 
than typing-in every singleline 
completely. In any case, some 
hard work is inevitably re- 
quired. 

Incidentally, enclosing my 
formulae with quote marks is 
what I did to obtain the print- 
out for my first table, which 
appeared with my submission, 
and in my opinion is a better 
way of printing one’s formulae 
to hard copy, than using the 


Abacus option contained in the 


PRINT command. 

Iwas puzzled by PH Warne’s 
suggested use of the dollarsign 
($) in Abacus. I have never 
come across this. .. my edition 
of Abacus will not accept it. I 
wonder how many readers 
have editions that will? 

Peter Tomlin 
London W2 


Well done 


Full marks for good customer 
service to Chris Boutal. Prob- 
lems encountered with V2.02 
of his excellent QL Genealogist 
running onmy reliableAH rom 
QL were quickly solved and I 
received his update V2.06. 
Chris identified that the 
Configurator file was not be- 
ing loaded correctly — that is 
now fixed. Other things were 
associated with AH rom pecu- 
liarities, and without getting 
hisown Am room from its loft, 
he fixed those too. Readers with 
AM and JM rons may like to 
note that a limit of 128 charac- 





ters can be read with the IN- 
PUT command. 

Some of my records were just 
over the limit, leading to a 
Buffer Full message and crash. 
Chris has rewritten the read- 
ing and writing routines in QL 
Genealogist to correct the error. 
Well done Chris, an excellent 
program and good customer 
service withit. My AH rom has 
been in daily use since 1985! It 
also purrs gently with Perfec- 
tion. 

Peter Harrison 
Brislington 
Bristol 


S Were) eta 


First may I compliment you on 
producing your New Users’ 
Guide. CL CHIP sounds more 
likea culinary delight, though! 
The major problem I have had 
is in punching the holes to file 
the pages in my QL Users 
Guide. You have kindly indi- 
cated the location of the holes. 
Like a lot of people, I have a 
wo-holepunchwhichpunchesho- 
les exa 
tly 80mm apart, just what is 
needed. In order to get the 
holes in the correct position 
, | need to locate the exact 
centre point between the holes 
a tedious operation. Pl 
ase would you print a centrin 
line between the printed h 
le positions?On an entirely 
ifferent prob 
em, lam using a Sandy Super 
board, version 1.6, which gives 
me 649K, disk interface and 
parallel printer port. Unfortu- 
nately, this version has only 
Toolkit 1. Plenty of suppliers 
offer Toolkit 2, but where can I 
obtain an upgrade from Toolkit 
1 to Toolkit 2? Sandy no longer 
seems to advertise. 
E E Stocker 
Clanfield 
Hants 





Editor’s comment: We'll see if we 
can get the layout artist to put 
some dots in. Toolkit 1 was the 
original Sinclair program. Toolkit 
2 was rewritten by Tony Tebby, 
and there is no “upgrade path’ 
between the two. To run Toolkit 2, 
you'll have to obtain it in 3.25 in 
disk, or eprom, and run it exter- 
nally to the SuperQboard. Care 
Electronics sell Toolkit 2,and say, 
if you want information or help, 
phone them on 0923 672102. 
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Robin Stevenson 
In December 1991, I reported in 
QL World on QL activity in the 
North American continent. It 
appears that a debate now 
reaching its third birthday, and 
mentioned in that article, con- 
tinues to rage in North America. 
The hotly contested issue is the 
amount of truth in reports that 
Cray Research, builders of some 
of the world’s biggest and most 
advanced computers, linked up 
a dozen or so OL motherboards 
to do research into parallel com- 
puting. 

Isuggested at the time that this 
report was ‘apparently true’. 
Originally I was prepared to 


C68 V2.00 


A major upgrade of the public 
domain C68 compiler has now 
been released. C68 2.00 comes 
with a full disk of documenta- 
tion, extra utility programs, and 
an expanded C programming 


Speedscreen 


Simon Goodwin’s Qdos screen 
accelerator Speedscreen, 
























CL Systems have been in touch 
to tell European readers that the 
CQVI video digitiser is now 
available from QLympic Com- 
puter Systems, Quellenweg 18, 
D-4220 Dinslaken, West Ger- 
many. 

Certain compatibility prob- 
lems reported by users of the 
CQVI and Miracle Systems’ 
Gold card are being looked into. 

In the UK the COQVI is avail- 
able straight from the makers. 
Orders and enquiries to CL 
Systems at 403 Chapter Road, 
Dillis Hill, London NW2 5NG. 
Tel: 081 459 1351. 































|Reyive loyal 
Quanta 
in May 







The London Quanta Sub-group 
are holding their third workshop 
on Saturday 30 May 1992, at St 
Helen’s Church Hall, St Quintin 
Avenue, London W10, between 
10am and 6pm. The Group will 
have a Help desk; a room for 
people to set up their own sys- 
tems for demonstrations or 
tinkering; new and second-hand 
software and hardware traders, 
and QL personalities, very 
probably eminent ones. 

For more information, contact 
Jerry Davies on 081 863 1631 or 
Colin Murphy on 071 328 5407, 
or write to the London Quanta 
Sub-group, 10a Lowfield Road, 
West Hampstead, London WN6 
2PR. 

They are hoping to attract en- 
thusiasts near and far. Don’t 
disappoint them. 


























has been re-launched with a £10 
price cut, and the release of a 
working demonstration into the 
public domain. 

The full version also acceler- 
ates the smaller text used by 
programs suchas the Psion suite. 
It includes founts, a character 
design task, and_ eight 
configurable versions to suit all 
systems. Speedscreen is avail- 
able on disk or microcassette at 
£10. The fast rom version (with 
all the extras on disk or tape) 
plugs into the QL rom port, and 
costs £20. 

Orders to CGH Services, Cwm 
Gwen Hall, Pencader, Dyfed, 
Cymru SA39 9HA. 
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ry links QLs to Cray computers! 










launched in QL World in 1987,~ 











believe that it was ‘apparently 
untrue’, but on the word of a US 
contact that he was confident of 
its truth, and that he had seen 
the photographs, I changed my 
mind. 

After publication, however, 
another reader of OL World 
wrote to say that, as far as he 
was aware, there was more fic- 
tion than fact circulating. The 
story first sprang, he assures me, 
from a Boston Sinclair /Timex 
Newsletter intended to be read 
in April 1989. Written anony- 
mously, with no picture, it 
described the contraption, 
claiming it had been labelled the 
Cray Z-2B. You have to say that 


quite fast, with an American 
4 3 

To the surprise of the perpe- 
trators, the story then surfaced 
asastraightarticleinanumber 
of other journals, creating, in 
the process, quite a few April 
Fools. Where the alleged pho- 
tograph came in is anybody’s 
guess, but the story refused to 
die. Whether there is more 
than that to this tangled web 
is hard to be sure. I now sus- 
pect that my _ original 
scepticism was nearer the 
truth. But life has an uncanny 
knack of paralleling art. Per- 
haps there is a Cray engineer 
out there whocan tellus more. 




























tutorial. The floating point maths 
library has been overhauled, and 
memory allocation is more 
flexible. C68 is available from 
Qubbesoft, CGH Services, the 
Quanta library, and as an option 
with Cport from Digital Preci- 
sion. Prices vary with source. 
Check which version is currently 
being supplied when ordering. 


Computer Systems, Jochen 
Merz Software, Jurgen 
Falkenburg Computing, and 
Albin Hessler Software. 
Workshops and discussions 
planned include Forth, a new 
animation application, Quill, 
SMS2 Qdos-compatible oper- 
ating system, Maulausch 
MausNet mailbox, the future 
of Qdos, OL networking, the 
public domain C68 compila- 
tion system, Fleet Tactical 
Command, and the latest 
Minerva rom. 

Quanta is organising a mini- 
bus party. The exact location 
is the Schulzentrum/ 
Realschule Munster-Roxel 
school, lilbecker Strasse 24, 
Munster-Roxel. Munster is 
served by major road routes; 
from the Intercity railway 
station, the number 19 bus 
reaches the school at the end 
of its run; a ‘white windmill 
without sails’ is the landmark 
for the school in Tilbecker 
street. The nearest airport is 
Munster/Osnabruck, 20 km 
away. 

More information is avail- 
able from Franz Herrmann, 














































More details on the Sinclair OL 
User Club eV International OL 
Meeting in Munster, Germany 
on 21 March 1992. The Meeting 
will run from 8am on March 21 
1992 to 10pm that same day. Set- 
up for demonstrators is possible 
from 4pm to 10pm the previous 
day (Friday 20 March). Clubs 
Sin _QL_ air (Netherlands), 
SQLUG (Sweden), Quanta 
(Great Britain), QLItaly (Italy), 
ONV (Denmark) and NASA 
(Norway). Commercial exhibi- 
tors on the list by the end of 
January included Miracle Sys- 
tems, IF Services, Dilwyn Jones 
Computing, PROGS Profes- 






















sional and Graphical Software, Talstrasse 21, W-5460 
Qubbesoft P/D, Ingenieurburo Ockenfels, Germany. Tel. 
Wilfried Krummery, QLympic +(0)2644 1855. 
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MIRACLE SYSTEMS 





tuart Honeyballis Miracle Systems. 
Not that Miracle is aone-man show; 
Stuart works with the best people 
in the field when he needs to, and 
has stayed on good terms with them. Mira- 
cle’s high-performance expansion board, 
the Gold Card, has roused more interest 
among street-level QL users than any- 
thing since the Thor was announced. 

Stuart is an engineer. After graduating, 
he worked for Ferranti, leaving after a year 
to go to Sinclair Research (before the time 
of the QL), where he worked on the pcb 
layout for the Sinclair Spectrum. He left 
Sinclair after nine months, tempted by a 
healthy rise, only to see his new employer 
go out of business. With some savings and 
no job, he set up his own business. 

“If they hadn’t gone bust, | wouldn’t have 
gone self employed,” he says, like many 
business people looking back on their 
origins. Miracle’s first major product was 
an RGB interface for the Spectrum. Like 
many a first stab, it probably cost its inven- 
tor money, but it taught him how to run the 
business. In December 1983 the QL was 
announced, and Stuart saw a glaring op- 
portunity straight away. 

“| immediately noticed that it didn’t have 
a Centronics port,” he says. “It seemed 
logical that there was a pretty large need 
for a serial to parallel converter, so thatthe 
serial ports on the QL, which are a bit 
specific to the QL, could be used to con- 
nect the QL to standard printers. We de- 
signed the QL Centronics Interface to do 
the job with the minimum of fuss. Oh yes! 
We're still selling them.” The converter has 
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Photo: David Drysdale 


a very low power 74HC164 chip at the 
heart of it. “It’s anice, simple device. Serial 
cards for printers cost around £60 or £70 
then. Some were over £100. Setting up the 
RS232 system is pretty tricky, as well. We 
started at £49, and with Centronics there is 
no setting up to do. They really made life 
easy for people. We sell them for £29 
now.” 

Getting information about equipment was 
far from easy. “We had to do most of it by 
intuition — you put yourself in the position 
of the designer, and guess what he did! It’s 
stood us in reasonably good stead. That 
was our first major product — we have sold 
about 15,000 of them. Other people cop- 
ied the design but we reckoned that, if we 
could come up with it in the first place, we 
were good enough to improve it. So we 
came up with a dual port one — the two 
serial ports are wired differently. Neces- 
sity is the mother of invention!” 


Expanderam 


The next important product was the 
Expanderam, their first occupant of the 
QL’s expansion port. CST already had a 
disk interface on the market; others fol- 
lowed, and ram expansion cards began to 
appear. Miracle’s ram expansion, how- 
ever, had an innovation — a through-con- 
nector. So was born the legend of the long 
QL! “So now they were buying their ram 
expansion from us!” The Expanderam also 
broke ground by implementing its memory 
controller in low-power HC chips, keeping 
the current demand on the QL (which can 


HITTING 
GOLD 


Miracle Systems are in their 
10th year of producing 
hardware upgrades for the 
QL. Helen Armstrong talks to 
Stuart Honeyball about hits 
past and present. 


deliver a maximum of 0.5 amps) low 
enough to run both an expansion card and 
a disk interface. 

Obviously, the next logical move was to 
incorporate the disk interface. The Trump 
Card was born, outrunning other disk in- 
terface/rams by using the entire QL ad- 
dress space. The maximised memory 
brought the Trump Card to 768K, and the 
QL to 896K. The device’s programmable 
rom has the disk drive software and Toolkit 
2 onit. All the software on their card-based 
products is written by Tony Tebby. Suc- 
cessful despite its protuberant outline, it 
became a legend in its own lifetime. 

Stuart sensed that memory was more 
important to users than peripheral space. 
The software of the QL is set up to run 16 
peripheral cards, but the hardware doesn’t 
have the space for it. “If you put more and 
more on one card, people are quite happy 
with that one card,” he has found. 

The newest ‘mainstream’ product is the 
Gold Card, marketed with loving care in its 
gold-patterned box. The Gold Card isn’t 
entrusted to common black carbon-im- 
pregnated antistat bag — because the con- 
tact would run out the battery of the bat- 
tery-backed clock. “We didn’t think about 
that until we were just about to send them 
out! Would have made the clock a bit of a 
waste of time.” 

So what does the Gold Card do that 
nothing else does? “Quite a bit really,” he 
says, in his understated way. His modest 
assessmentis that, with the 16 MHz 68000 
processor, programs run about four times 
their usual speed. “People notice that. 
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We've had a lot of nice letters about it. It 
makes a big difference to programs like 
Quill and SuperBasic.” The Gold Card 
operates by copying the contents of the 
QL rom to its own 2 MB on-board ram. 

So he’s builta QLon acard? “That's right 
— it does everything apart from the I/O and 
the housing.” The screen has been 
speeded up by shadowing, so that write 
cycles go to the QL to update the screen, 
but read cycles come from the fast ram. 
The disk interface section uses a new disk 
controller, to handle the same disks as the 
Trump Card (at 720 K), as well as the new 
breed of 3.2 floppies. It exploits double 
density (DD at 720K), high density (HD at 
1.44 MB) and extra high density disks (ED 
at 3.2 MB). Setting their own standards, 
Miracle eschewed the PC standard 2.88 
MB ED disks. “The QL is not a PC, so it 
seemed a bit daft to settle for 2.88 when 
we could have 3.2.” 


Four-layer board 


Like the Trump Card, the Gold Card has 
no through-connector. “It would have been 
very difficult. But we have more com- 
plaints about the Trump Card sticking out 
than we do about either of them not being 
able to address other cards!” The Gold 
Card boasts a meticulous hand-laid, four- 
layer motherboard, carrying (among other 
things) the 68000/16 processor, four 4Mbit 
drams, the 8473 disk controller, and the 
message ‘Hi Dawn!’ Dawn is Mike 
Tomlinson’s wife — Mike laid out the board. 
Who says that romance is dead? “By 
putting a Gold Cardin, youcan stop the QL 
crashing,” adds Stuart, “because the 
processing takes place on that board, rather 
than in the QL.” 

So you don’t need a QL to run the QL any 
more? Just a boot rom? “And some |/O, 





and afew other things,” says Stuart. “We’re 
thinking about something along those lines, 
but we can't say exactly what at the mo- 
ment. If we’d talked about the Gold Card 
before it came out, it would have been 
completely different from what we’d told 
you. We got quite a long way down the 
design of one gold card, then we scrapped 
it and started again. We realised that we 
could get it all inside the QL. We added 
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things and dropped things. We didn’t want 
to put the price up or make it larger.” 
The Gold Card has done well. Launched 
in May 1991, it has sold twice what was 
expected. There has been a groundswell 
of enthusiasm for it, even among those 
who don’t have one. Some people have 
tried the PC, Stuart reckons, and found it 
doesn’t do what they want it to do. The QL 





Right: Gold 
Card... Below: 
peeking out of the 
QL. 


is friendly to use, and 
it does true 
multitasking, which 
the pc doesn’t seem 
to be able to do it 
properly, even under 
Windows 3. My engi- 
neering consultant 
agrees. 

“We’ve made enough out of the GC to 
persuade us to go along and do the next 
logical thing,” says Stuart seriously. “There 
are two things that need addressing: the 
graphics need improving, and we really 
want to replace the QL hardware. Fax 
cards are “one thing we have in hand, but 
there’s a lot more than that. If everybody 
went over to buying a QL or a QL compat- 
ible,” he adds, “it would create a lot of 
British jobs.” 

Stuart travels to Europe with his bike to 
drum up overseas orders. “If they don’t 
see you, they won’t buy,” he says. “They 
don’t want to risk their money.” He laugh- 
ingly describes the horrors of cycling across 
the vast, cobbled Place de la Bastille, with 
Parisian drivers whizzing crazily around 


them. He takes his bike across Europe on 
the train, and then cycles. That’s a long 
journey. A short journey is Nottingham — 
80 miles each way, with his monitor and rig 
on his back. “You can get quite alot ona 
bike,” he says earnestly. He used to have 
a flash car, but he worked out what it cost 
to keep it standing in the drive, was of- 
fended, and sold it. He makes a good case 
for rail transport. 


BSE RS 


MIRACLE SYSTEMS 


Mild-mannered Honeyball is also of- 
fended by banks, and stays away from 
their loan facilities as much as possible. 
"It's only the big four which are a problem," 
he says. They bank with the TSB, getting 
interest on the account. "It's people who 
have personal accounts with those banks 
who enable them to go on working in an 
inefficient manner. You can get cheque 

“aie 





eres 3 


ERS 


accounts from several Building Societies." 
People are listening carefully to this sort of 
talk these days. | comment that it doesn't 
take much, at the moment, to make peo- 
ple twitchy. If anyone is out of touch for a 
while, QL World gets letters and calls. 
More than we used to. 

| put to Stuart the claims occasionally 
voiced that Miracle have ignored the work 
of other developers. "We have incorpo- 
rated some of Lawrence Reeves' code, at 
his request, to make the Gold Card Min- 
erva compatible. My conscience is clear 
on that point!" he says. "Wherever we can, 
we have changed things, which has in- 
volved us in quite a lot of work. We didn't 
design the Gold Card to be part of an 
expansion system; but we take all com- 
ments on board, and we attempt with each 
new product to make it compatible with as 
much as possible." Subject, of course, to 
meeting their original design criteria. Stuart 
attributes much of his stability to knowing 
what the market wants. 


Indignation 


The notion — lobbed at not a few design- 
ers over the years — that they designed 
their master product to be difficult for other 
QL designers to follow through, rouses 
nearly aS much indignation as the banks. 
"We don't do anything cynical like that at 
all," he says promptly. "That is completely 
against our philosophy. Where we have 
cut off avenues, it's either where we just 
haven't thought about it, or where it ena- 
bles us to provide more in that particular 
product. On the Trump Card, we went for 
768K, but you can't add other expansion 
cards. The vast majority of people prefer 
the extramemory. We don't envisage peo- 
ple using the Gold Card with other expan- 
sion cards — it fits neatly inside the QL." It's 
hard to please everyone. Games players 
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soon told him that the Gold Card went too 
fast. "Now we have a SLUG command. 
You can slow the card down to any speed 
you please!" 


Design balance 


| sense a fine judgement balancing the 
benefits of building their own standards, 
and meeting the criteria of other design- 
ers. Their success has been their survival: 
one of the few businesses which supports 
itself — development, contract work like 
Tony Tebby's software, Stuart and his full- 
time employee Mike — entirely in the QL 
market. You can only do that on reliability, 
trust and repeat custom. Miracle also of- 
fers a 14-day money-back-if-not-entirely- 
satisfied guarantee on all its products — "I 
don't know why more companies don't do 
it. It sets people's minds at rest, and we 
only get back about one a year." And two 
to three day delivery —"We find the post is 
reliable, but if it doesn't work well, you can 
use a Carrier." 

They have worked to make the Gold 
Card compatible with as much software 
as possible without moving away from 
their original concept. "We've got plenty of 
space inside the rom — we can keep on 
adding patches, but it does take a lot of 
work." All the software on Miracles card 
products is written by Qdos author Tony 
Tebby. "All we do is pass comments to 
him and ask him if he can get it working 
with this, or that." Tony is actively working 
with Miracle, although he is seen about 
the QL community less these days than of 
yore. "He's a good bloke, though, old 
Tony. We pay our bills. A lot of people 
have been ripped off in the QL business. 
lf we say we'll pay for things, we do, even 
if we can't use them in the end." It's a 
policy which has worked for them. 

Miracle have made their mark with other 
products over the years — the QL Modem. 
"Probably the product I'm most proud of! 
I'm pretty sure it was the smallest one in 
the world when it came out. It uses 
optocouplers instead of an isolating trans- 
former." The modem is no longer on sale, 
but it was a best seller in its day. Miracle's 
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Midi board, on the 
other hand, was 
only adequate." 
The software 
wasn't what people 
wanted. | gave the 


Right: Cornered! 
Mike Tomlinson 
works for Miracle 
full time. Below: 
Old friends. The 


MIDI to Quanta in Trump Card 
the end. It was a settles down with 
fair bit of work to a good book. 


churn out, and we 
want to concen- 
trate our resources 
on the high end 
stuff." 

Miracle also pro- 
duced a hard disk 
drive, now over- 
shadowed by the 
Gold Card. "We 
find people are 
happy with 3.2 MB 
disks — since the Gold Card we've sold 
fewer hard disks, because the floppies 
are now big enough. PC software tends to 
be verbose. QL Software is concise, so 
hard disks are less necessary. We solda 
respectable number, but it's not a product 
| particularly like. Some users require large 
storage, and bulletin boards do, butit's not 
really a mainstream item." 


Rebuilding the QL 


What he really wants to do is rebuild the 
QL. "The operating system is the principle 
advantage of the QL — the soul of the 
computer. Itwas released before the bugs 
had been got out. Tony Tebby wrote it in 
abut three weeks. He has to be congratu- 
lated on writing such a sophisticated oper- 
ating system in such a short time! He's re- 
written the operating system now. He calls 
it SMS2. It's likely to appear in one of our 
products." 

There will be an advanced QL 'some- 
time this year’. Deciding what to include 
takes most of the time. You have to weigh 
things up. It must be what people want, at 
a price they are prepared to pay, ina time 
scale that we can afford to do it. We don't 
want to go away from standards if there's 

no advantage. The 
keyboard in any 
product would sim- 
ply be a PC key- 
board, and we would 
provide a pc key- 
board interface. We'd 
put a Centronics port 
in. We don't want to 
get tangled up in the 
commodity end of 
things. We want to 
<j provide what people 
4 can't get anywhere 
{ else." The idea be- 
1 hind such a 'new' QL 
will be to run QL pro- 
grams much faster 





than they currently run. Programs which 
need code from a microdrive will be a 
problem, and may not be implemented 
until someone writes a patch. "That's get- 
ting rather close to piracy, and we don't 
want anything to do with piracy." They 
expect to be able to use the 68030 and 
68040 in due course. "They are faster and 
better than the 68020." There are various 
clock rates available. "We will always give 
the best value for money basically." 
There's a lot of thinking involved. While 


Test rigs 


developing the Gold Card, they rigged up 
a 68020 to test. "We were extremely dis- 
appointed with the performance. The 
68020 atthe same clock rate as the 68000 
runs 1.5 times as fast! If we had used an 
expensive 68020 with a high clock rate, it 
would run the Gold Card twice as fast, but 
double the price. | don't think that's eco- 
nomic." 

It's as well Miracle take such trouble, 
because it proves that their faith isn't 
blind. "| think the outlook for the QL is quite 
good. We've gone so far down the line, 
and we don't want to leave the market," he 
says. "And | personally don't feel I've 
finished my mission yet. There's still a few 
things to do." And so say all of us. 
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INFORMATION 

Program: Picturemaster_Plus 
Supplier: 

Dilwyn Jones Computing 
41 Bro Emrys 

Tal-y-Bont 

Bangor 


Gwynedd 

LE57 S3YT 

Price: £24.00. 3.5 or 5.25 disks 
only. 

Requires at least 256K 
memory. A monitor should 
be used. 


John Shaw 
gets a pictorial 
update. 


oe Hafke is something of a 
perfectionist. Heis always 
searching for better ways 
of improving the product. 
such is the case with 
Picturemaster Plus. 

It has much in common with 
the original Picturemaster, 
which I reviewed in the No- 
vember 1991 issue of OL World. 
You can now use very large 
text (up to eight times CSIZE 2, 
1 in height). There is the addi- 
tion of triangles to drawing 
tools (single, or patterns). Pa- 
per and ink colours in Text 
Window can becontrolled. Part 
of a screen may be magnified. 

The screen picture can be re- 
peated in condensed form. 
There is full customisation of 
drive, printer and sound de- 
faults, and a combined Fill and 
Pattern facility. 

Youcan now adjust the screen 
image position, Storeand Blend 
Screens. Handwriting can be 
carried out directly on to the 
image. There are now 15 more 
pre-designed screens. 

Should you require it, you 
can generate a continuous 
show of the 45 pre-designed 
screens. 

A very useful bonus, particu- 
larly to those intending to use 
it for advertising, etc., are the 
three lines of auto-centralised 
text which are now available. 
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icturemaster Plus 


With regards to the screen 
painting, Joe has introduced a 
novel concept by allowing us- 
ers to have at their disposal a 
number of Pads, with different 
shape painting faces, such asa 
line, a box, an ellipse (includ- 
ing acircle) anda triangle. Each 
of these Pads consists of two 
parts: the outer, narrow rim 
and the inner core. If only the 
outer rim is used, the single 
line outline of the figure ap- 
pears on the screen, but if the 
figure is to be filled then both 
the inner and the outer parts of 
the Pad can be employed to- 
gether. 

Any paint colour within the 
range of colours available for 
the screen MODE chosen, in- 
cluding the Stipple colours, can 
be used and you can consult 
the full QL colour chart, if you 
wish, each time you are re- 
quested to choose a colour. 

No drawing, text printing, or 
erasure is ever irrevocably 
committed. The latest effort can 
always be ‘undone’, without 
affecting the work previously 
invested in making up the 
screen. 

The Handwriting is really the 
use of a small Box (rectangle) 
with automatic Fill and Leave 
Trails, although the size of this 


Pen Box can be increased and the 
box rotated, like any other Box 
(but probably tolittleadvantage). 

An additional Handwriting 
facility is an optional grid of 
horizontal lines (like lined sta- 
tionery) to keep the writing in 
a straight line. 

Another Picturemaster Plus 
facility is the option to Move 
the whole Screen picture if it 
appears to be growing lopsided 
as detail is added (a frequent 
experience of mine). In this op- 
eration itis possible to lose parts 
of the picture by Scrolling, or 
Panning over the edge of the 
Window (WINDOW #1). 








As anaid,a temporary line in 
a contrasting colour is dis- 
played at all the four edges of 
the Window and remains in 
that position however the 
screen picture is moved. 

Whereas most of the text 
printing facilities are similar to 
those contained in the earlier 
program, a major addition is 
that of Very Large Print. This 
enables printing of Shadowed 
text of up to eight times the 
height of QL CSIZE 2, 1, with 
the character thickness 
‘fudged’ to keep it in readable 
proportion to the height. 


Blending 


Picturemaster Plus has a 
memory ‘Store’, large enough 
fora complete screen. A Stored 
screen can be Blended with the 
currently displayed screen. 
Blending produces a combina- 
tion of the two screens, eachon 
alternate horizontal pixel line. 

Selecting this option starts a 
continuous, dynamic display 
of all the 45 pre-designed 
screens being generated. It is 
one of the principle features of 
this program that the user is 
guided atall times without ever 
losing sight of the Screen being 
designed. 

As in Joe’s previous work, 
the bulk of the program is 
supplied in fast loading Basic 
code to enable users to adapt it 
and ‘tinker’, as they may wish. 
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QL GOLD « CARD 


£375 inclusive (£330 export) 
e 2 year warranty ° 14 day money back guarantee °« 






« The GOLD CARD is the ultimate 


expansion for the QL. It speeds up program 


execution by a factor of about four, 
increases the memory to 1920K bytes and 


¢ All the functions on the TRUMP CARD, i.e. 


TKIl, printer buffer, screen dump, RAM disk 


and memory cut, are carried over to the 
GOLD CARD. 


enables the QL to interface to 3.2M Byte 
disk drives (as well as 720K and 1.44M). 


There is a battery backed clock so that the 
QL powers up with the correct time and 
date. 


¢ We offer part-exchange for old expansions: 


¢ The floppy and RAM disk drivers now 
support sub-directories. 


JOIN QUANTA ! 


QUANTA is the independent QL user's club. If you have not 
already joined then consider the following: 


QUANTA stands for “QL Users and Tinkerers Association” 
ae and provides a forum for users to get together. 


Members requiring guidance on software and hardware can 
seek out expertise from fellow members. 


Local sub-group meetings are regularly held throughout 


Part Ex. Item 
TRUMP CARD 2 
TRUMP CARD 768K 
TRUMP CARD 256K 


GOLD CARD price 


£225.00 (£200.00 export) 
£275.00 (£241.00 export) 
£300.00 (£263.00 export) 
£325.00 (£284.00 export) 
£325.00 (£284.00 export) 
£325.00 (£284.00 export) 
£350.00 (£305.00 export) 


much of Britain. 


There are also workshops where we and others demon- 
strate our wares. Members have access to a large software 
library and can often find spare parts and second hand 
bargains at QUANTA meetings and can see new products. 


bea! £14 (£17 overseas) subscription includes an informative 
ne. Most of all, it is good fun so contact 

the tite Slamnbiorship Secretary, Bill Newell, 213 Manor Road, 

Benfleet, Essex, SS7 4JD, or telephone (0268) 754407 now! 


EXPANDERAM 
DISK CARD 

RAM + DISK I/FACE 
Other Expansion 





| To: MIRACLE SYSTEMS Ltd, 25 Broughton Way, Osbaldwick, | 
York, YO1 3BG, U.K. Tel: (0904) 423986 


Please send me 


encloseachoque tote valueol ££ oeye Fae ee 
Or debit credit card ERaeBbBeak lL atakga 


(0904) 423986 


To place an order by phone 
please have your credit card 
ready. For overseas customers 
we charge the prices shown in 
brackets. 


| 
| 
| 
| 
| 
| 
| 
| 
quoting your credit card : Address 
% 


To order by post, please fill in gee) 

the form opposite or write to us Name Signature 

number and expiry date, or 

enclosing a cheque payable to 

MIRACLE SYSTEMS Ltd. fix 7 eel ee ee i id ae eal 





MIRACLE 


SYSTEMS 
2—= 


TRUMP CARD 768K 





£100 inclusive (£89 export) 
1 year warranty 


The TRUMP CARD is an ideal low-cost upgrade 
for the QL. The 768K RAM adds to the QL’s to 
give 896K. There is a disk Interface for double 
density (DD, 720K) drives - either ours or 
compatible types. Toolkit Il is included which 
gives many useful additions to the operating 
system. 


(0904) 423986 


To place an order by phone please have your 
credit card ready. 


3.2 MBYTE 
DUAL DRIVE 


If you currently have an order with us or are 
considering ordering the 3.2 M byte DUAL DISK 
DRIVE then please note that we are 
experiencing difficulty in obtaining the 
mechanisms at a Suitable price. This has led to 
long delays In delivery of this product. We 
sincerely hope that you will agree with us that 
we should not pay over the odds for goods 
imported from Japan and that you will bear with 
us until the negotiationscan be resolved. 
Please also note that when used with the 
TRUMP CARD diskettes will only give 
Capacities of up to 720K bytes. 

















We are exhibiting in: 


LONDON: 
14th March 1992 
Novotel 
Hammersmith 
GERMANY: 


21st March 1992 
Schulzentrum/Realschule Miinster- 


Roxel, Tilbecker Strasse 24, Munster 
BRISTOL: 


25th - 26th April 1992 

Walten Park Hotel, Clevedon 
BRUSSELS: 

2nd May 1992 

Eurovolleycenter 

Beneluxlaan, Vilvoorde 





QL CENTRONICS 


£29 Inclusive (28 export) 
One year warranty 


The QL CENTRONICS PRINTER INTERFACE 
enables a printer with a standard Centronics 
parallel port to be connected to the QL with 
great ease. The interface plugs into the 
Centronics port on the printer and has a3 metre 
cable terminated by a QL serial plug. The serial 
plug can be plugged into either SER1 or SER2. 
Nothing else is required. 


MIRACLE SYSTEMS Ltd, 25 Broughton Way, Osbaldwick, 
York, YO1 3BG, U.K. Tel: (0904) 423986 


HALF A LAPTOP 








David Drysdale finds 
the 288 is the ideal 
driver for his portable 
printer. 


decided years ago that my laptop, when 
| got round to buying one, would be a 
PC. It would assuage that nagging 
feeling that somehow | was being 
sidelined by sticking solely to the QL, and 
there were so many PC models to choose 
from and so many programs around. 

That was the idea, of course, but the 
reality is that | have very little use for new 
programs. My QL is a workhorse with a 
daisywheel printer for its ‘cart’ and, to- 
gether, they are ideally suited for a free- 
lance journalist. 

Word processing is the main require- 
ment of most self-employed people, and 
good old Qui// has been a mainstay. It is 
slow, and pretty inept on very long docu- 
ments, but it gives little trouble with my 
stories which seldom run to more than 
2,000 words. 

However, one hiccup to my working sys- 
tem occurs because | am often away from 
home — sometimes for eight weeks at a 
time — cruising my canal boat, and work 
needs to be carried out during this period. 
The last time | set out to cruise, an editor 
rang just as | was leaving, asking for along 
article, with pix, on a subject | had never 


The ‘office in a briefcase’ — the Z88 
and a Brother EP44 type/printer. 





ios OR sae NMEOE TOG eee picor Keen Puneet 4 
Ciane soba TeSeee siibmn vote estat anak enn Shee | 


FSS ae ne OR, Lees ces Rice eae, Se, 


ee a Sn, ne Ces See | 
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HALF A LAPTOP 





The author’s floating office — the canal boat Pegasus. 


tackled before. The deadline was in ten 
days’ time — holiday or not. 

Situations like this mean using my 
Brother EP44 electronic typewriter, but 
any typewriter is a word processor. The 
EP44, however, has a couple of features 
that started me thinking again about a 
laptop. 

Firstly, this typewriter has a serial port 
and doubles up as a battery-driven port- 
able printer, ideal to link up to a laptop. 
Secondly, it can download a paragraph or 
two of text matter directly to a QL, and this 
showed me how useful a laptop with the 
Capacity to download a story would be. 

The ability to transfer text matter to the 
QL was hampered by the fact that, in Quill, 
the documents acted like lumps of con- 
crete and wouldn't reformat without my 
painstakingly removing surplus spaces, 
etc. line by line. 

Then Digital Precision’s Perfection word 
processor came along, and | was able to 
turn those chunks of concrete into pliable 
putty. | found | could work well by typing 
out stories in odd moments and 
downloading to the QL for making up and 
printing, but the memory limitations of the 
EP44 soon became burdensome. Not a 
real computer, it was only ‘half a laptop’, 
and something better was needed. 

The phrase ‘half a laptop’ kept running 
through my mind. Because my work was 
being downloaded into QL with a colour 
monitor, PC-type keyboard, memory 
upgrade and twin disc drives, there was 
no need to duplicate these facilities. Half 
a laptop was what | needed — the key- 
board. 

A glance through the catalogues soon 
picked out a machine — the Cambridge 
Z88. It was one of the least expensive, far 
smaller and lighter than any of the others 
and — not having a full-size screen or disc 
drive — could operate on four pen-torch 
batteries. Although the machine fitted into 


my ‘half a laptop’ category it is, in fact, a 
computer with a built-in word processor, 
spreadsheet, database and diary. 

This full specification made the computer 
ideal. By linking it to the Brother EP44 
typewriter/printer, | had full wordprocessing 
facilities and could tackle any editorial 
assignment from the canal boat. The only 
drawback was that memory could be very 
expensive in comparison to disc storage. 
A one-megabyte ram pack, for example, 
could cost£215, anda250K plug-in eprom, 
the Z88’s only system of built-in perma- 
nent storage, costs around £65. 

From a half-a-laptop point of view, this 
didn’t matter. If the data could be 
downloaded into the QL and saved on 
disc, the problem was solved. A 128K ram 
pack and a 250K eprom pack, costing 
£103 between them, give ample storage 
for the periods on the boat. 

A commercial pack for linking the Z88 to 
the QL can be purchased — as can all 288 
equipment — from TK Computerware. In 
the event | had acable made up by Adman 
Services of Telford, and sent for Phil 
Borman’s freebie QL-Z88 link program 
from Quanta. This program disc, Comms 
1, also gives cable-wiring instructions. 

The first piece successfully transferred 
by this system was a file from the Z88’s 
Pipedream database. It was received in 
no fit form to be used on the QL, but when 
transferred to the Z88 again it loaded asa 
perfect Pipedreamfile, solving the problem 
of inexpensive storage of Z88 files. 

The next test—the crucial one—was how 
the Z88 would transmit text files, which 
would have to be imported into the QLina 
form that could be used for word process- 
ing. The Quanta program was designed to 
transfer text files acceptable to Quill, and 
this it did successfully using the ‘Import 
line by line’ facility. The text, however, 
would still not reformat in the same way as 
Quill-produced files, and was not ideal. 
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The Z88 linked to the extended QL; the QL itself is tucked 
away beneath the wooden plinth. 


Perhaps there is some facility in Quill for 
overcoming this drawback, but | looked in 
vain for it. 

The next step was to try the same thing 
with Perfection, and here it loaded in an 
entirely different form. There is no ‘import 
line by line’ facility in this software. The file 
was loaded in the conventional way, but it 
came into the QL in one continuous line 
completely filling the line buffer. Only part 
of the document could be loaded. 


Reformatting 
One answer to this was to reconfigure 


the program line buffer, but there is also a 
facility within Perfection to split extra-long 
lines which would have the same effect. 
Once this was sorted out, the reformat text 
command rapidly knocked the document 
into shape. 

End of line codes were also visible on the 
screen, but the search and replace facility 
which, in this program has the power to 
remove embedded codes, soon cleared 
them out. Success at last. The two halves 
had come together to give me all the 
facilities | needed. 

There is a limit to what can be accom- 
plished, of course. It is not possible with 
the Quanta software to convert Z88 










DISA 


Pipedreamfiles into 
QL Archive, for ex- 
ample, but the Z88 
is a fully fledged 
computer in its own 
right, with notebook 
facilities such as a 
computerised diary. 

Having used a 
paper diary for 
years, | looked on 
the idea of a com- 
puter based diary 
with suspicion and, 
sure enough, hav- 
ing spentsome time 
making entries to 
the 288, the whole thing was wiped out of 
memory when | plugged the machine into 
a mains transformer. This is apparently a 
weakness of the 288, although, according 
to the handbook, it is rare for files to be lost 
inthis way. The next model of the Z88, due 
out in the Spring, will have a separate 
battery backup for the rampacks to pre- 
vent this happening. 

Perhaps the most useful feature of the 
diary is its ability to search, list and print. If 
arecord was needed, say, of letters posted 
over a period of time the computer would 


EASYPTR 


Development System for the Pointer Environment 


Menu generator EASYMENU 
Design menus on the screen 
Sprite generator EASYSPRITE 
Design sprites, blobs and patterns on the screen 
SuperBASIC Toolkits EASYMEN/EASYPTR 
Menu and pointer control in SuperBASIC programs 
Assembler source code generator EASYSOURCE 
Create commented menu definition source code 


Budget version £33.00 Full version £49.00 


HALF A LAPTOP 


search them out and provide a printed list, 
complete with dates, provided thatthe items 
had been linked with a keyword, such as 
‘posted’, for the program to search out. 

The Z88, of course, will not suit every- 
body, particularly those wanting a full sized 
screen instead of the Z88’s half a dozen 
lines, but for most of the time | don’t even 
look at the screen. | just churn out the 
words, and sort the whole thing out when 
it reaches the QL. For anybody wanting 
half a laptop that will do a full-sized job, | 
can thoroughly recommend the Z88. 











Interactive disassembler £29.00 











Export prices excl. VAT and incl. p&p (Europe only) 





Albin Hessler Software - Im Zeilfeld 25 - D-7447 Aichtal - Tel. ( )7127/56280 
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ATARI /QL EMULATOR 


ONE MANS 


aa es. 





or the last nine months, I have 
been using an Atari Mega 2 with 
one of Jochen Merz's OL emulator 
boards init. Ihave no hesitation in 
saying thatitis superb, and would recom- 
mend it to anyone with the money to 
spare. Note that it will not work onanSTE. 

In detail, my system consists of Jochen's 
own Extended4 emulator board and ac- 
companying software, together with a 
Philips colour monitor and a Power 
Computing 40 MB scsi hard drive. Al- 
though the total outlay amounted to about 
£1200 (£400 for the hard disk, close to £200 
for the emulator once I'd paid the VAT, 
and £600 for the computer and monitor, 
which I bought second-hand through the 
pages of MicroMart), and I hesitated for at 
least 18 months before making the move, 
[have no regrets at all. 

I fitted Jochen's board myself, having 
sent off for it by post and having had to 
pay VAT to the postman on delivery. In 
principle, the fitting was not difficult ex- 
cept for one operation, but it took some 
nerve, and I am used to soldering. Six or 
seven wires had to be soldered to the 
mother board, which was easier than I 
feared, but one had to be soldered to the 
glue chip, and removing the chip from its 
socket to do the soldering was difficult 
and scary. The design of the chip itself 
also means that when you push it back 
into its socket, it is easy for short-circuits 
to be made inadvertently between the 
corner legs on the chip. Fortunately, the 
chip is robust, and does not seem to have 
been damaged. Cutting two of the tracks 
on the mother board was also an alarming 
first for me, but in principle straightfor- 
ward, if crude! On reflection, I would 
probably ask Jochen to install the board if 
[had it to do again, although this would 
involve horrendous postage costs. 

The software that comes with the emu- 
lator includes among other things a first- 
class transfer utility for reading from and 
writing to MS-DOS disks. I use it all the 
time. 

Once installed, the emulator is a dream 
to use. I paid out the few extra pounds for 
Odos on Rom, so that the machine boots 
straight up into Qdos on power up or 
reset. From there on, it is a very fast, 
totally reliable QL with massive memory. 
The one program | had to change was the 
Psion printer driver, to take account of the 
Atari's parallel printer port — which also 
needed a proper parallel cable, of course. 

My use of the computer means that 
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lereM 


Hugh de Saram is an 
Atari/QL emulator 
enthusiast. 


multi-tasking is an absolute first priority, 
since I switch constantly between word- 
processing and database applications, 
together with occasional spreadsheet 
work. Ideally, I need three databases 
running all the time, so even with a 768 k 
Trump Card the QL is inadequate. Mira- 
cle's new Gold Card would be an alter- 
native now, but the Atari is, I feel, both 
more elegant and more durable as a piece 
of hardware. The Mega keyboard is par- 
ticularly good. So I use Qpac II, and run 
one copy of TurboQuill+ and three of Ar- 
chive, together with some of the utilities 
from Qpac I - calculator, calendar, and 
above all the configurable clock/calen- 
dar which I can pop up with the current 
date (always correct, since the Mega has a 
battery-backed clock built in), and then 
paste straight into my Quill letters by 
pressing ENTER. 

I have no call for graphics applications, 
so I cannot comment on the compatibility 
of QL graphics programs with the Atari 
hardware; Jochen would be able to an- 
swer any questions over the phone. He 
was very patient with me as I went about 
fitting his emulator board and speaks 
excellent English! 

Adding a hard disk to the Atari makes 
the machine a real power house. The scsi 
format makes for extremely fast data 
transfer, and allows more than one hard 
drive to be daisy-chained from the com- 
puter's one hard-drive port. I also find 
that, once everything is booted up, it is 
perfectly all right to switch the hard-disk 
off and on as needed, while leaving the 
rest of the computer running: my par- 
ticular drive unit is not quite as whisper 
quiet as it is advertised to be, despite not 
having a fan, so I only flip it on when I 
actually need it. 

One modification I have made is to the 
keyboard cable. I wanted all the com- 
puting clobber to be on a rack of shelves 
beside my desk, so as to leave the actual 
desktop clear except for the keyboard and 
monitor. So I went out to Tandy's and 
bought a six-wire telephone extension 
cable, and then to a local computer bits- 
and-pieces shop for the little plug units 
for each end of the cable, and made my- 





self a two-metre keyboard cable. Now 
that there is a DIY tower box available for 
the Atari, designed to stand on the floor 
beside your desk, you can actually buy a 
ready-made long keyboard cable. 

The speed of the Atari means that Quill 
can no longer be accused of being slug- 
gish, and with the enhancements pro- 
vided by TurboQuill+ - the glossary 
function in particular — it becomes the 
excellent budget WP it has always been 
for the MS-DOS system — yet without the 
document length limitation which that 
system so annoyingly imposes. 

Archive outperforms its MS-DOS 
brother on XT hardware, although QL- 
Archive lacks a couple of features of the 
MS-DO$ version. File sorting is especially 
fast, somewhat making up for the lack of 
index files. 

If lever feel that, with the move up inthe 
MS-DOS world to 286- and 386-based 
machines, the Atari/OQL has become un- 
acceptably slow, there are a number of 
accelerator boards now available, from a 
16 MHz upgrade of the 68000 chip, to 
68020 and 68030 replacements. Whether 
the last two work with the emulator, I 
couldn't say, but the first one does. 

Equally, although for the moment 2 MB 
of Ram is quite adequate for my needs, 
there would be no difficulty in having 
another two installed. And if I were will- 
ing to put out quite alot more cash, [could 
replace the Memory Management Unit 
and award myself the capability of in- 
creasing memory up to about 16 MB! 

Finally, the greatest attraction of the 
Atari/QL is that it is on this machine that 
Tony Tebby seems to be concentrating his 
software development efforts. What other 
argument do you need? 


INFORMATION 


OL Extended 4 Emulator £163 + VAT 
Jochen Merz Software 

Im Stillen Winkel 12 

4100 Duisburg II 

Germany. 

Tel: 010 49 203 501274. 


Power Computing Slimline 40MB scsi 
hard disk £425 

Power Computing Litd. 

Power House 

44A Stanley Street 

Bedford MK4 7RW 

Tel: 0234 273 000. 
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NEW 


SER GUIDE 
KEYWORD INDEX 


This month in the Keyword Index, Mike Lloyd starts with 
DIM array and ends with ED #chan, line — something to 
channel your thoughts 








“OI NEW 








DIM array(x,y,Z...), 


array$(x,y,Z),... 
MEMORY VARIABLE COMMAND 
xX, yandz Integers between 0 and 32767 representing the number of elements in a given 
dimension 
(X,Y,Z) A list containing at least one array dimension 
array User-defined name of a numeric array 
array$ User-defined name of a string array 


Arrays are extremely useful because they allow you to associate similar items of data. For instance, 
in a program for use by a school secretary there might be arrays called PUPILS, CLASSROOM and 
TEACHERS. With 12 classes comprising at most 30 pupils, and with 15 teachers and 21 classrooms, 
the framework of a database could be established with the following command: 





100 DIM pupil$(12, 30, 20), teacher$(15, 20). classroom(21) 


Note that the last dimension of string arrays refer to the maximum length of the element. Pupil$(12, 
30, 20) indicates that there are 12 lists (one for each school class) with 30 places (one for each 
classroom place) each of 20 characters (the maximum length of a pupil’s name). 

SuperBasic arrays have in practice no limit to the number of dimensions they can have, provided that 
sufficient memory exists to accommodate them. A one-dimensional array can be thought of as a list, 
and a two-dimensional array is like a table of columns and rows. Arrays with three dimensions are like 
a series of tables and arrays with four or more dimensions begin to stretch the imagination too far and 
are thus rarely used. 

In line with earlier Sinclair products, the QL has a neat but novel way with string arrays. A string array 
with one dimension, eg DIM string$(12), is logically identical to an ordinary string variable which 
happens to be limited to 12 characters. Digital Precision’s Turbo compiler treats all strings as if they 
were one-dimensional string arrays with a default maximum length of 100 characters. Longer strings 
are declared as one-dimensional arrays with the appropriate number of character elements. 

The QL initially allocates enough memory space only to hold the pointers needed to navigate through 
each array. Space for the data itself is only added when an array element is assigned a value. The QL 
is still quite advanced in its approach as most computer languages seem to prefer allocating huge 
chunks of memory to arrays whether they contain data or not. 

With string arrays the QL remains frugal by allocating memory based on the actual contents of the 
string, not on the declared maximum length. However, the QL always allocates an even number of 
bytes to a string, so a declaration of DIM oddstring$(11,15) will actually produce an array which has 

Se 11 elements each holding a maximum of 16 characters. The QL’s interpreter is prone to a very irritating 
error message when a program line declaring an array has been written but not yet run. Normally, if 
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DIMN (arrayname,dimension) 


DIR #chan, device 


you use a variable name which the QL does not recognise it prints a friendly asterisk (or ‘twinkle’, as 
my programming friends now insist on calling it). If the undeclared variable name has been used in 
a DIM statement which hasn’t yet been executed you will get an ‘Error in expression’ message instead. 
This can lead to lengthy and fruitless agonising over the syntax of a perfectly valid command. 


Two problems immediately confront programmers new to arrays: sorting them into order and saving 
them for later use. Sorting algorithms were honed to a high standard by the mid-1960s with two 
significant developments. The first was the ‘quicksort’, an elegant, recursive sorting technique which 
has been published at least twice in QL World. The second was the idea of indexing cumbersome 
strings so that they never change their physical sequence, but are accessed via a second array of 
numeric pointers which is easier and faster to re-arrange. 


Saving arrays is simple due to the unifying principles of Qdos: an array is just a type of variable and 
a file is just a type of device. An array can be printed in its entirety with the command PRINT 
arrayname$. Instead of printing to the screen or printer, the same information can be passed to a file 
by opening an appropriate channel: 


100 OPEN_NEW3#S, mdv1_arraystore 
110 PRINT#3, myarray$ 
120 CLOSE#3 


The problem comes, unfortunately, when it is time to reload the array. You have the data in a file and 
you have the array details in a program. How can they be married together again? Your program 
should have a sequence like this: 


500 DEFine PROCedure loadarray 

510 DIM myarray$(30,20) 

520 OPEN_IN#4, mdv1_arraystore 
530 FOR x = 170 30 

540 INPUT#4, myarray(x) 
550 END FOR 

560 CLOSE#4 

570 END DEFine 


MEMORY VARIABLE FUNCTION 
arrayname The name of a previously-declared array 
dimension The dimension about which statistics are sought 
DIMN returns the number of elements present in an array, or the number of rows in acolumn of a multi- 
dimensioned array. In the entry for the DIM keyword an array of PUPIL$(12, 30, 20) was declared. 
DIMN can be used in a program to reveal the dimensions of the array in the following manner: 


100 PRINT DIMN(pupil$, 1); “ classes with ...” 
110 PRINT DIMN(pupil$, 2); “ pupils with ...” 
120 PRINT DIMN(pupil$, 3); “ characters in their names” 


DIMN comes in particularly handy when arrays are declared at different times with different sizes. 


FILE HANDLING COMMAND 
#chan (Optional) a valid SuperBasic channel 
device A valid media device 


DIR is short for ‘Directory’ and it causes a simple list of files to be printed to the default window or to 


the given channel. The output begins with the name of the microdrive or floppy disk and an expression 
of the number of used sectors and the total number of sectors. Each sector holds 512 bytes of 
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number1 DIV 
number2 


DLINE, line, line TO 
line, ... 


DLIST #chan 


[Super Toolkit II] 


Sinclair/QL World April 1992 


information. Super Toolkit I/ slightly modifies the behaviour of DIR so that it can take advantage of 
Toolkit Il’s default directories. 


The simplest way of trapping directory information so that its presentation can be improved is to divert 
the output to a file. The following routine is called with acommand such as SHOWDOCS “flp1_”. It will 
list only Quill files, assuming that Quill filenames end with the suffix _ doc: 


500 DEFine PROCedure showdocs (drive$) 
510 LOCal DIRfile$, loop, filename$ 
520 DIRfile$ = drive$ & “dirfile” 

530 DELETE DIRfile$ 

540 OPEN_NEW3#S, DIRfile$ 

550 DIR#3: CLOSE#3 

560 OPEN_IN#S, DIRfile$ 

570 REPeat loop 

580 IF EOF (#3): EXIT loop 

590 INPUT#S, filename$ 

600 IF “ doc” INSTR filename$ 
610 PRINT filename$ 

620 ENDIF 

630 END REPeat loop 

640 CLOSE#3 

650 END DEFine 


All this effort can be avoided with Super Toolkit Il. It contains a WIDR command which allows you to 
specify any part of a filename which must be matched. 


INTEGER OPERATOR 

number1, number2 Valid numbers 

DIV is not strictly speaking a keyword but an operator. In other words it is from the same family as +, 
-,“ and /, but it happens to be an operator in the form of a set of letters rather than a symbol. Other 
similar operators are INSTR and MOD. DIV performs an integer divide, throwing any remainder away. 
None of the variables involved needs to be declared as an integer, so LET X = 8.9 DIV fraction is quite 
valid. Ifthe result was being placed in X% instead, DIV would perform exactly the same as “/”. The main 
benefit of DIV is that it can be used with floating numbers which can assume much higher values than 
the QL’s integers. 


PROGRAM EDITING COMMAND 

line A positive integer representing a line number 

When SuperBasic reserved the keyword DELETE for file handling, something else had to be found 
to delete program lines. The clumsy DLINE was therefore coined. DLINE is normally followed by only 
one parameter, either a single line number or a range of lines, but any number of parameters can be 
given provided that they are separated by commas. Super Toolkit II includes a full-screen editor which 
does away with the need for DLINE altogether. Its equivalent is to position the cursor on the offending 
line and pressing CTRL-ALT-left arrow. 


FILE MANAGEMENT COMMAND 
#chan (Optional) A valid SuperBasic channel 
Super Toolkit Il allows you to declare default directories for program files, data files and destination 
files, PROGD$, DATAD$ and DESTD$ respectively. Rather than indulging inasetof PRINT PROGD$ 
commands to remind you of what the settings are, Super Toolkit Il includes the handy DLIST command 
which puts all three settings onto the screen, or to a given channel, automatically. Note that, like 
SuperBasic’s DIR, DLIST is more use at the direct command level than in programs. 
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DNEXT dir_ level 


[Super Toolkit Il] 


DO filename 
[Super Toolkit II] 


DUP 


[Super Toolkit Il] 


ED #chan, line 


[Super Toolkit II] 


FILE MANAGEMENT COMMAND 

dir_level A fragment of a directory name 

Super Toolkit Il’s soft directory structures are implemented with some interesting commands, of which 
this is one. A directory is defined as a set of files which each begin (or end) with the same sequence 
of filename fragments. Filename fragments are separated by underscores. In the filename 
flp1_work_temp_SQLW_index_doc the directory fragments are _work, temp, and _SQLW. The 
device name fragment is flp1_, the filename fragment is index and the filename suffix is_doc. Super 
Toolkit Il has commands to move up and down the directory levels and it has DNEXT, which moves 
sideways. Assume that the default data directory has been set so that we can access the index_doc 
file directly (DATA_USE flp1_work_temp_SQLW_) and that we now want to use files prefixed with 
flo1_work_temp_HOME_. Rather than issue another DATA_USE command we can simply say 
DNEXT home. For readers familiar with the DOS and UNIX directory structures, DNEXT is the 
equivalent of ..\HOME. 


PROGRAM COMMAND 

filename a valid filename 
DO is a lovely addition to SuperBasic because it executes files of commands. Unlike the SuperBasic 
LRUN command, DO only works with commands which do not have line numbers. This means that 
the DO file cannot include any multi-line structures such as procedure definitions and the long forms 
of IFs, REPeats and FOR...NEXTs. However, Tony Tebby believes that including calls to SuperBasic 
procedures and functions within the DO file causes no problems, but of course it must be assumed 
that the definitions are part of a SuperBasic program which is already in the QL’s memory. DO properly 
closes the command file when it reaches the end, whereas SuperBasic’s MERGE command leaves 
it open. 

lf you have a sequence of commands which you frequently call from several programs, it would be 
worth considering saving them to a text file and calling that file with DO. When writing programs | like 
to rearrange the default windows so that the listing window occupies the entire left hand side of the 
screen. A narrow but long command window and a very small default window are relegated to the right 
hand side of the screen. The commands which lay the screen out in this way are in a file called 
“edit_screen” so that they can be carried out with the direct command DO edit_screen. 


A further advantage of this technique is that once the commands have been carried out they are 
removed from the QL’s memory, thus preserving more space for data and for those program lines 
which cannot be relegated to files. 


FILE MANAGEMENT COMMAND 
DUP is another of Super Toolkit Il’s directory commands. For a brief discussion of the directory system, 
see the entry for DNEXT above. DUP has no parameters. It removes the last directory segment from 
the default directory name, thus having the effect of moving up one level of the directory tree. If the 
default directory is flo1_work_temp_home_, issuing the DUP command changes itto flp1_work_temp_. 


PROGRAM EDITOR 

#chan a valid screen (console) channel 
line an integer representing a line number 
Perhaps the biggest disappointment on the QL, even taking into account microdrives, is the crude 
program editor. Tony Tebby quickly developed a full-screen editor, invoked by the ED command, 
which is now incorporated into Super Toolkit II. The irony of it is that even the earliest QL ROMs have 
more than enough space to include a full-screen editor, but the decision to do without one was taken 
during the fruitless attempts to cram all the ROM code into 32K. 

A full description of ED belongs in the Concepts section of the New User Guide. Suffice to say that 
using ED instead of EDIT, DLINE and AUTO is alone worth the cost of buying Super Toolkit Il. 
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INFORMATION 

Program: Filemaster 

Supplier: Dilwyn Jones 
Computing 
41 Bro Emrys 
Tal-y-Bont 
Bangor 
Gwyned 
£12.00. Mdv, 3.5in 
or 5.25in disks. 
Expanded QL 
with at least 256K 
extra memory and 
a ramdisk system. 








hy write another 
file handling pro- 
gram when there 
are already many 
such programs on the market? 
asks author Joe Haftke in the 
opening paragraph of the 13- 
page Manual which comes 
with this utility. 

He answers his own ques- 
tion by saying: “There aremany 
excellent file handling pro- 
grams in existence, but none of 
them performs all of the tasks 
which are necessary to look 





Pope aS 









LEMURS 


ELE 


John Shaw 
looks at a new 
file handler 

designed to do 
everything. 





FILEMASTER 


after a system of files.’ 

Does this one? Well, you be 
the judge. The Filemaster capa- 
bilities are listed as: 

Batch copying of up to 144 
files to one or more medium. 
The selection needs only to be 
made once and can be assem- 
bled from several different 
media. 

Deletes redundant files from 
different media using a single 
selection of all redundant files 
from all the media involved. 

Formats cartridges and disks. 

Displays media Directories 
of up to 72 files per screen in 
four columns without scrolling. 

Prints ordered directories 
with date across the page (250 
per A4 size page provided your 
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printer can use condensed 
script). 

Prints ordered directories of 
up to 50 files on a 3.5in disk 
label. (Printer must be able to 
handle Superscript.) 

Prints both the above direc- 
tories, grouping together files 
beginning with the same letter 
(upper or lower case). 

Files can be viewed on screen 
or printer. 

Can it be used with your 
system? 

Well, this program requires 
the availability of an already 
active ramdisk system catering 
for eight ramdisks. It will 
however run from microdrive, 
floppy disk or hard disk. A 
monitor is obligatory. 


An expansion of 256K is es- 
sential, however, one of 512K 
or over is a decided advantage, 
as the free memory decides the 
number of files that can be 
handled in a single selection. I 
estimate that a Trump Card will 
cope with the bulk handling of 
about two thirds ofa 1440 sector 
floppy disk in one selection. I 
can confirm that a Gold Card 
will hold the entire contents. 

In essence you have a file 
system which collects all files 
from your chosen sources and 
puts them into a ramdisk from 
Where they can be manipu- 
lated. They are then down 
loaded to whatever media you 
choose with good speed and 
efficiency. 


The whole procedure is menu 
driven and error trapped. 

The program is provided 
with an easy-to-understand 
manual and a large section de- 
voted to make sure that your 
particular printer can be 
configured to produce the 
necessary size of print to use 
on the disk labels. 

To summarise, Filemaster is 
a well written utility, provid- 
ing a comprehensive ability to 
arrange, rearrange, merge and 
print all your files. An asset to 
all OL users, an absolute must 
to all owners of hard disks and, 
of course, those fortunate 
people intending to buy the 
new Miracle Systems 3.2 
megabyte disk drives. 
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word processor is a very personal 
thing. It takes a while to get used to 
it; then you find that you can’t do 
i% withoutit. Whenanewonecomes 
along, you find that you can’t get into it 
because of the familiarity of the old one. 
Your attachment amounts almost to an 
addiction. that is the only way to explain 
why so many people still use Quil/ (apart 
from the fact that you have to pay for 
anything different). 

Quill is adequate for producing a short 
document, but it has difficulty handling 
long documents. Its range of operations is 
restricted. Its major defect is that it is slow 
enough to drive you mad if you need a 
word processor frequently for reasonably 
long pieces of writing. The problems with 
Quill have led to the production of a steady 
stream of alternatives. 

The field is so rich that I’m going to 
restrict myself to a few of the many pro- 
grams which could conceivably be used 
for word processing. | shall leave out text 
editors in which printout is a secondary 
consideration, so | shall ignore Spy, 
Master Spy, QD and The Editor in its or- 
dinary version. | shall also avoid desktop 
publishing programs, which provide 
methods of laying out pages of text and 
graphics, and in which it is often easier to 
read in text from a file created by another 
program. This means ignoring another 
range of excellent programs — Front Page, 
page Designer, and the three (!) DP 
packages — Desktop Publisher, Special 
Desktop Publisher, and Professional 
Publisher. | shall also ignore other pro- 
grams capable of doubling as a word 
processor — notably the excellent 
FlashBack. 


Meet the Editor 


What are we left with? The Editor Spe- 
cial Edition (which unlike its ordinary sister 
has a proper printer driver), text87, and 
Perfection. |t could be that price is a major 
determining factor in the choice of program. 
For the versions | shall deal with, the 
current prices are The Editor Special Edi- 
tion 2.05 nearly £50; for text87 3.01 £60 
(though recently | have seen it advertised 
only with companion programs for nearly 
£95); for Perfection 2.00 nearly £80. Note 
thatthe price of text87 includes as standard 
the Qjump spelling checker and English, 
French and German dictionaries. If you 
want the massive dictionary that goes with 
Perfect Plus (one of the biggest computer 
dictionaries every compiled), the price tag 
goes up to nearly £120. 

The first Quill substitute to emerge was 
The Editor from digital Precision. As its 
title suggests, it was a text editor rather 
than a word processor, and had no dedi- 
cated means of producing anything so- 
phisticated in the way of printed output. It 
was followed by the Special Edition of The 
Editor, which included acommand to make 
a file into a document, and came with a 
separate printer driver. 
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THREE 


Man’s best friend — the word processor. People 
become so devoted to theirs that they never 
change until circumstances force them. Others 
spend their lives in search of ‘WP Right’. How do 
you choose, asks three-timer Mike Edwards’? Is it 
the facilities — or just chemistry? 


| took to The Editor like a duck to water. 
Unlike Quill, it doesn’t use menus (which | 
dislike anyway) and instead offers a list of 
about one hundred commands which you 
enter and execute directly from the key- 
board. The commands you normally need 
are easy to remember after a little practice, 
and give you comprehensive control over 
the file you are working on. There are 
simple, fast search and replace commands; 
i's easy to perform block operations and 
you can save command files to perform 
regular tasks. The Editor makes it fairly 
easy, for example, to take a list of ex- 
changes and telephone codes, reverse it 
into a list of codes and corresponding 
places, and rearrange the list into numerical 
(or some other) order — all automatically, 
through a command file. You just couldn't 
do that with Quill. Norcan you do it with any 
other word processor that | know of and 
that is one good reason why | see no 
likelinood of giving up The Editor! There is 
a penalty for this flexibility: if you want to 
make full use of The Editor, you have to be 
prepared to think quite hard at times. 


Editing file: winkled_up_ survey 
File type : Text 

Margins: Lit Inds i R: 22 
Tab interval: 3 
Right just. + No 
Block start + = Undefined 
Block end +: G= Undefined 
Marker point: = Undefined 
Last search : F// 

Repl, string: 

Buffer sizas: 87834 15368 
Buffer usage: 48% 23% 


- Press any key to continue - 
alternatives. 


Block Type: Line 


The problem with The Editor is the sepa- 
rate printer driver, which | couldn't get on 
with. The link between it and The Editor 
seemed tenuous, and using it was like 
being on an escalator — one way only. 
Instead, | wrote my own printer driver, with 
a nice friendly front end, rather like the 
Turbo front panel, but with more on it, so 
that you can change your mind about 
pretty well everything before actually is- 
suing the fatal instruction to print. | would 
not be surprised if many other users have 
done the same, or have used The Editor 
for preparing text to be read in finally to 
Quill, or perhaps text87. 


Introducing text87 


The next contender in the field was 
text87, which has now reached version 3. 
This is a proper word processor, with a 
built-in printer driver. It also makes 
strenuous efforts to be friendly towards 
Quill users in an effort to win them away 
from the original program. It uses menus, 
even though they are at the ‘wrong’ end of 


The field is so rich, that I'm going to restrict myself severely 
to a few of the many programs which could conceivably be used for word 
processing. I shall leave out text editors in which printout is a 
secondary consideration, so I shall ignore Spy, Master Spy, 8D and The 
Editor in its ordinary version. (But I shall include The Editor Special 
Edition which has a proper printer driver.) I shall also avoid 
desk-top-publishing programs which attempt to provide methods of laying 


out pages of text and graphics, and in which it is usually easier to 
read in text from a file created by some other program, This means 
@ Line: 1 Col: 1 Line count: 598 Mode: Insert 





The Editor: the information screen and text style. 
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the page, and some of the items look 
similar to Quill. But there the similarity 
ends. Text87 is a much more sophisti- 
cated piece of software which offers as 
nearly complete control over both screen 
and printed output as it is possible to wish 
for. Results from it are super. 

It is also a bit of a pain to work with, 
because however ‘fast’ it is (and it does 
what it does very quickly indeed), itis also 
slow, because of the complexity of its 
operations. The other major drawback of 
text87 is its manual. Very nicely presented, 
the manual has a big red logo in the middle 
of every page to distract the reader or 
discourage photocopying. It also fails to 
explain clearly a great deal. 


It’s Perfection 


The latest word processor is Perfection 
— again from Digital Precision, but very 
much more than a re-vamping of The 
Editor. Every effort has been make to 
make Perfection easily accessible to Quill 
users. There is the same system of menus 
(but more than in Quill) and in much the 
same format, in the same position on the 
screen. There is also for those who dislike 
trundling through menus, a system of 
keypresses to do the same jobs but faster. 
In lots of ways, Perfection is more intelli- 
gent than Quill and, above all, it is much 
quicker — very quick indeed in many of its 
operations. Searches are extremely fast. 
File-handling is as quick as anyone has a 


Ruler ( 


[ Line spacing 20/180") [ Justified | 


right to expect. Perfection is quicker to 
load, and loads and saves files faster than 
its competitors. 

So: how do you choose? Here is a point- 
by-point comparison which may help you. 
It's only fair to add that it doesn’t help me 
to eliminate any of the programs: | shall still 
use all three, for different purposes. 

Since | am going to spend quite a lot of 
time carping about more or less minor 
flaws in these programs, it would be as 
well to state here that all are excellent, 
well-documented pieces of work. 

Manuals are a sore point with computer 
users. Their philosophy is: if all else fails, 
read the manual. Everyone wants to get 
on with the computing with as little trouble 
as possible — a fact which producers of 
hardware are well aware of! But you can- 
not expect to make full use of a word 
processor, or any other piece of sophisti- 
cate software, without taking some time 
and trouble over it. 

Allthree manuals are heavyweights. The 
Digital Precision manuals show a strong 
family resemblance. The Perfection 
manual has 104 A4 pages. This is a lot 
shorter than the manual for The Editor, 
which has 150 A4 pages. However, The 
Editor’s 100 or so commands are sum- 
marised on just over two sides — and this 
is the bit of the manual that will need most 
attention, with only occasional reference 
to the rest to be sure exactly what a par- 
ticular command does or how it is used. 
The commands are grouped in alphabeti- 


[ Selected | 


ALTERNATIVES TO ARCHIVE 


CHOOSING A WORD PROCESSOR 


A Word Processor is a very personal thing. 
then you find that you can't do without it, 


It takes @ while to get used to it; 
And whe @ new one comes along, 


you find that you can't get inte it because of loyalty to the old one, Your 
attachment amounts almost to an addiction, That is the only way to explain why 
so many people still use Quill - apart from the fact that you have to pay for 


anything different, 


Quill is adequate for producing a short dacument. 


Hs major defect is 


that it is 30 slow enough fo drive you mad if you need a word processor 


frequently for reasonably long pieces of writing, 


The problems with Quill have 


led to the production of 4 steady stream of ulternatives. 

The field is sa rich, that I'm going to restrict myself severely to a 
fey of the fiany programs which could conceivably be used for word processing, 
| shall leave cut text editors in which printout is a secondary consideration, so | 


()  Prestiqa PS Sty 


Text) nebi_document 


Words: 





0 Normal 


870 Lines 16 Frame: text aren 


Text 87 showing the ruler and typeface 
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WORD PROCESSORS 


N THE HAND 


cal order which happens usefully to be 
much the same as their grouping accord- 
ing to function. Much the same is true of 
Perfection: again, two or three sides con- 
tain the essential reference material — 
though the grouping here is less helpful, as 
ithappens. There is an interesting disparity 
between the spirit of the DP advert, which 
refers to ‘jargon-free, friendly but to-the- 
point documentation (that you will probably 
never need to read through!)”, and the 
documentation itself, which more than once 
(rightly, in my view) advises study of the 
manual. Although the manual is very thor- 
ough on the whole, | have managed to 
generate just one error that | cannot find there 
(to be specific: ‘picture-printer absent’). 

With text87 you get a more standard 
type of handbook — A5, comb-bound, and 
very nicely printed, except that you can get 
very tired of the big red logo splashed 
across every page. Otherwise, | found this 
the least approachable manual. It is hard 
to find what you are looking for, even with 
the help of the index, which sometimes 
doesn’t mention what you’re hunting for 
(‘proportional spacing’ makes no appear- 
ance there, for example; nor does ‘spac- 
ing’). The essential information about the 
command system occupies almost 30 
pages — too long far quick reference, and 
although at times quite verbose, it’s often 
not very helpful. An example is the expla- 
nation of the Feature command in the 
Context sub-menu, which, we are told, 
‘Selects the fount to represent the whole 
group of Printypes that are in the selected 
Feature’. | know text87 quite well, but | still 
don’t quite understand that. What it is 
supposed to mean to a new user, | can’t 
imagine. Writers of manuals need to keep 
in mind that it is more important to be 
comprehensible than strictly accurate. 


Know it first. . . 


Of course, it has to be said that some of 
the things the program does are compli- 
cated, so you can’t expect the manual to 
be simple. But | constantly feel that this is 
a manual with which, like so many manu- 
als, itis bestto know everything before you 
start reading it. On many topics, the index 
contains several page references — and all 
too often, none of them tells you what you 
need to know to use a facility. It took me 
hours to work out how to get page numbers 
in the middle of the page, (or anywhere), 
and I’m not, | believe, more stupid than the 
average QL user. The manual tends to hint 
in the general direction of an explanation, 
and then leave it up to you. 
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WORD PROCESSORS 


The problem could be resolved quite 
simply: What is required is a new section 
entitled ‘How to prepare a document, 
which would run quickly (much more briefly 
than the present 30 pages on ‘The 
Document’, at any rate) though the basics, 
and indicate where to find more informa- 
tion. 

Only the Perfection manual fails to offer 
an index—a major failing for any reference 
work in my view, but we understand that a 
full index will become available. It does 
however include a glossary which some- 
times tells you where to look for details. It 
also includes material that has nothing to 
do with the program; for example, it ex- 
plains the term ‘proportional spacing’ — 
which the program does not offer. This 
helps to put the functions in context. 

All three programs have configuration 
systems, and they all allow you to change 
a great deal. There were no problems 
configuring The Editor, and the other two 
programs worked well in general. There 
are a few grouses about them, and some 
not so minor. In fact, | was unable to 
persuade either Text87 or Perfection to 
do exactly what | wanted them to do 
without using The Editor to amend the 
task files directly. 


Configured out 


This was a minor problem with Text87. 
You could say it was rather an effect of my 
choosiness about filenames than anything 
else. | wanted to use sub-directories on 
hard disk, and text87 seems not to have 
been designed with that in mind. No doubt 
Version 4 will take hard disk on board. 

Configuring turned outto be difficult with 
some aspects of Perfection. One prob- 
lem is with the page which amends device 
and filenames. Every time | gotto ‘Current 
default font device file name’, the 
Configurator locked up—without my trying 
to alter anything! Since | cannot imagine 
DP not noticing this effect, it is likely to be 
something to do with my particular set-up. 

My other, more general grouse about 
these programs (and about configuration 
programs in general) is that they are one- 
way systems: no going back or second 
thoughts allowed; you have to start again 
at the menu. A control panel (such as DP 
themselves use with Turbo) seems amore 
user-friendly way of doing it. 

| would say from my own experience 
that The Editor is quicker to type into than 
Perfection. This is partly because Perfec- 
tion is doing so much more. The other part 
is Perfection’s personal way of doing 
things. When you are right at the beginning 
of a document, Perfection has a discon- 
certing habit of constantly re-writing the 
whole screen, or panning to left or right. 
Although you know that you can continue 
typing (the manual tells you so, and ex- 
perience bears it out), It’s nevertheless 
distracting. A real no-look touch-typist 
might get on a lot better than me. The 
Editor does the same sort of thing, but to 
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FEATURES OPTIONS 
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Text87: the typeface selection screen 


a much less distracting extent. It also 
seems to work faster in re-orienting text 
on screen. The Perfection manual tells 
you that it’s a good idea to set the right- 
hand margin sufficiently to the left to avoid 
constant panning. | like to work with 80, or 
at least 72 columns, both of which fit on 
the screen, but which involve panning 
until the text gets big enough to discour- 
age the program from doing it. The Editor 
will cope with my settings happily. 

Text87 has a different philosophy. The 
characters are not standard QL sizes, so 
you can fit more or less as many as you 
want on to the screen, and vary the size of 
them at will; so no problem with panning. 
Text 87 also reformats automatically as 
you type in, so that if you insert into 
existing text, it will all move along or down 
to accommodate what you have included. 
This can slow things down, producing a 
rather ‘spongy’ feel to your typing, and 
can also be distracting. In contrast, when 
you insert text into The Editor and Per- 
fection, you often have to issue a com- 
mand to re-format. Re-formatting can take 
time, even with a short paragraph. 


100 commands 


All three programs have around one 
hundred commands. As you would ex- 
pect. The Editor offers many more op- 
tions for doctoring the text, numbering or 
reordering the lines, and searching and 
exchanging.This is, after all, what it is 
designed for. The other two programs 
concentrate on preparing text for printing. 

Both The Editor and Perfection have 
Help pages, and those in Perfection are 
particularly clear, and in alphabetical or- 
der which to some extent makes up for the 
lack of indexing. 

Text87 has no help screen, and it can be 
confusing to tell which command gives 
what you want, particularly since some of 


the commands are also sub-commands 
under a different heading. Ruler, for in- 
stance, is both a fully-fledged command, 
and a sub-command in both Block and 
Doc. Nevertheless, once you get used to 
it, the command system is very logical, 
and no more complex than it needs to be. 


First letter logic 


The Editor has logically grouped com- 
mands. All those for cursor navigation, for 
instance, begin with c : cs for the start of a 
line, ce for the end, cp for the start of the 
next paragraph. Block commands begin 
with b. This arrangement usually gives 
clear clues to what command you need to 
enter next. Confusion can still occur. Me- 
tathesis holds special dangers: for exam- 
ple, pr (reformat a paragraph) differs radi- 
cally in effect from rp (repeat commana). 

The commands in The Editor are very 
snappy. You tap F3 followed by the code 
you want—normally one or two letters, but 
if you want to exchange a string the com- 
mand can be quite long. As there is no 
menu system, you must either remember 
the command, keep the manual nearby, 
or screen the help pages. 

Perfection boasts both a menu system 
of four menus, and an immediate com- 
mand system. F3 is used to cycle through 
the menus, and a single keypress then 
accesses any command on the menu. 
The immediate command system is a 
natural one, involving, as far as possible, 
the use of initial letters with combinations 
of ALT, CTRL and SHIFT. The system 
has been thought out carefully to avoid 
clashing with other uses (CTRL/c to cycle 
jobs, ALT/letter under Qram or Qpac). 
There are some minor annoyances, inevi- 
tably. If you use the menu system to 
toggle justification, you have to go through 
menu 0 three times to reach left-justifica- 
tion. Total key-presses: nine! But in the 
immediate commands, three times CT RL/ 
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a does the same job. But why return to 
menu 0 every time? 

Now for an example of howthe command 
systems work in practice: we will replace 
‘The Editor’ with ‘Perfection’ throughout a 
document, using each program in turn. 

The command format for The Editor is: 


F3 rp;e.The Editor.Perfection. ENTER 


This would replace every occurrence of 
‘The Editor’ with ‘Perfection’ throughout a 
document from the cursor point. F3 ac- 
cesses the command system; rp tells the 
computer to repeat the operation; e means 
exchange the following strings. 

Toachieve the same effect in Perfection, 
you must first search for a string (CTRL/f). 
Having found it, you then enter a replace 
string (CTRL/v), and then give the com- 
mand for an immediate replace CTRL/x) 
either backwards or forwards, depending 
on which direction is pre-set. Example: 


CTRL/f The Editor ENTER CTRL/v Perfec- 
tion ENTER CTRL/x 


You can do the same thing more slowly 
through the menu system. 

Unlike the DP programs, text87 offers 
only case-sensitive search, and would en- 
tirely fail to find ‘text87’ in this article. 
(Perhaps | ought to point out here that 
Software87 themselves use a small initial 
't’.) Like all the other commands, you have 
to use the menu system, typing F3 first to 
access the menu, then s for Search. Find- 
ing your string is fast and easy once you’ve 
got the case right, and to exchange you 
need to include a special marker character 
obtained with F5. The example is: 


F3 s The Editor F5 Perfection ENTER A 


The final Ais required because, when the 
program finds the search-string, you are 
asked if you want to Replace, Continue 
searching, replace All further occurrences, 
or ESCape. 

Isn't it amazing that there are three such 
different methods of tackling the same 
task? 

All three programs offer comprehensive 
file handling facilities. They include merg- 
ing files, saving native files, exporting files, 
importing foreign files and saving selected 
parts of a file. 

The programs offer different methods of 
reading ‘foreign’ files. The Editor will read 
anything — ru is the command for Quill or 
other odd files, while plain r does for Editor 
files. The unformatted read allows you to 
work on binary files, executable jobs, or 
whatever. Just as well: | would never have 
been able to customise Text87 or Perfec- 
tion to my personal requirements without 
this facility! 


Importing text 


Text87 offers you the chance to import 
Ascii, Quill or text87 Export files. In the 
case of an Ascii file, you are invited to read 
in ‘normal’ (ie as it comes) or ‘paragraph’ 
format (ie with paragraphs formatted as in 
Text87). 

Perfection is easily the cleverest pro- 
gram in this respect. It will read, recognise, 
and act appropriately on Perfection, Quill, 
or plain text files without any user encour- 
agement. Great! However, if you want to 
export a plain text file, you must either use 
a separate supplied program, Stripsort, to 
remove all the bits and pieces that Perfec- 
tion puts into the text, or else set up a 
printer driver to do the same job. | should 
add that the primary aim of Stripsort is, as 
its name implies, to sort material as might 
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CHOOSING 


A WORD PROCESSOR 


A Word Processor is a very personal thing, [t takes a while to get used to it: 
then you find that you can't do without it, And when @ new one comes along, 
you find that you can't get inte it because of loyalty to the old one, Your 
attachment amounts almost to an addiction, That is the only way to explain why 
so mony people still use Quill - apart from the fact thet you have to pay for 


anything different. 


Quill ts adequate for producing a short document, but it has difficulty 
handling long documents. Its range of operations is restricted, Its major defect is 
that it if slow! enough to drive you mad if you need @ word processor frequently 
for reasonably long pieces of writing, The problems with Quill have led to the 


production of a steady stream of alternatives, 


The field is so rich, that I'tr going to restrict myself severely to a few 
of the many programs which could conceivably be used for word processing, | 
shall leave qut text editors in which printout is 4 secondary consideration, so | 
shall ignore Spy, Master Spy, QD and The Editor in its ordinary version, | shall 


Text: neig_document 





Words: 6283 


Lines Frame: text areq 


Text87: display of different character sizes 
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be required if Perfection is used for data- 
base handling: the stripping of attributes 
from a file is secondary. 

Unlike Quill, all these programs read 
complete files into memory. This means 
that memory limitations can be a problem. 
Most programs expect you to set memory 
limits before reading in a file. The Editor 
works like this. In the case of text87, you 
have to set the limits before executing the 
program itself. If insufficient space is allo- 
cated, you have to reset memory limits, 
and re-execute the program before the 
new limits can become operative. Again, 
Perfection is very smart and organises its 
own memory dynamically to reflect the size 
of the file you want to work with, avoiding all 
these problems. 

The DP programs both warn you if a file 
already exists, and ask if you want to over- 
write. Only text87 operates a sudden-death 
system of saving exactly what you tell it to, 
without any queries. So text87 is conven- 
ient, but only if you’re 100% sure you know 
what you’re doing! How many of us can say 
that at all times? 

The display is very clean in all three 
programs. Screen size is user-configurable. 
All three programs offer, or can be 
configured to offer, just a blank rectangle 
and a status panel at the bottom of the 
screen. All three programs incorporate an 
automatic word count, even The Editor if 
you ask it to treat a file as a document. But 
then even Quill did this. Perfection can 
have, and defaults to showing, a menu at 
the top of the screen. Text87 keeps three 
lines at the bottom of the screen for menus, 
status information, and user responses. 
You can also show file information (the 
current ruler, in fact) at the top of the 
screen. The Editor uses just one line at 
the bottom of the screen for status infor- 
mation, command entries and reports. Each 
program can display about 15-24 lines of 
text at a time. 

The Editor is simplest of the three pro- 
grams. There are two alternative screens: 
the Help screen, and the status screen, 
which usefully shows you which defaults 
you are operating with — left and right 
margin positions, the current file-name, 
and so on. 


Status lines 


In Text87 the status line shows the cur- 
rent line number and the number of words 
in the document. In some modes, it shows 
a variety of other information. The com- 
mand line is blank until you switch on the 
relevant menus with F3 and sub-com- 
mands. Another line is available for entering 
responses, or for further information. There 
the simplicity ends, however. Text87 has 
an array of other screens to deal with. 
There is a page-layout screen to help you 
set the overall parameters of your docu- 
ment. Then there is a Ruler screen which 
helps you to set tabs and margins and line 
spacing. Finally, there is a Type screen 
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which you canuse to select which typefaces 
your printer will use. 

In text entry mode, text87 has a useful 
toggle which allows you to show the at- 
tributes of the current line. Its ruler (mar- 
gins and tabs) appear at the top of the 
screen, while the status line at the bottom 
shows the typeface used. 

Text87 lets you alter the size of charac- 
ters on the screen. You can select different 
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fact that you have to oau for anuthino different. 


defect is that it (s so slow enough to drive you mad if you need a word 


processor frequently for reasonably long pieces of writing. The 


EXECUTE PROGRAM 18 
LORD FILE 9 

IMPORT FILE a 

SAVE FILE f 
GOTO BOTTOM’ TOP 6 
MOVE BLOCK 
REPLACE STRING 45 13 


COLI 


Quilt ts 


QUILL EDITOR 
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scales and compression ratios to corre- 
spond to what is on the printed page. | use 
the default scale, 60%, which easily per- 
mits 80 columns and more on the screen. 

Perfection lets you choose whether to 


Fi HELP 
F2 Menu on screen 
F3 Menu 1424341 


Tt takes a while to get used 


TEXTE? 


SHIFT/F1 last cmd ESC EscapeCancel 
SHIFT “Fi Modes ¢+ SHIFT/FS one/tuo - + SHIFT para‘word 
SHIFT/F3 Menusez+1 windows FS selects + SHIFTAALT window 
Fd Refresh screen SHIFT/F4 Size/Move ALT/FS Over/Insert CTRLYC toggle job 


display the menu on start-up. You can, of 
course, toggle the menu display on or off 
with F2. Otherwise, there is just a plain 
screen with a status line at the bottom. On 
start-up, the page appears to occupy a 
fixed number of lines regardless of whether 
or not the program is configured to display 
the menu. If you configure not to use the 
menus, the typing rectangle normally has 
some blank lines at the bottom correspond- 
ing to the number 
of lines which would 
have been in the 
menu. This is quite 
nice —it means that 
the cursor is usu- 
ally abouttwo thirds 
of the way down the 
screen, where your 
eye naturally is, and 
not at the bottom. It 
also, unfortunately, 
can look as though 
you are at the bot- 
tom of your docu- 
ment (or para- 
graph) when you’re 
not: it’s justthan the 
end of it is hidden 
until you scroll 
downwards. It also 
means that if you 
do get material into 
that lower section 
of the screen, it 
won't normally go away until you press F4 to 
re-draw the screen, the Help pages. Toggling 
the menus on an off seems to remove this 
effect, and you can then play with the whole 
document window. 


niet] or 


PERFECTION 
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CHOOSING A WORD PROCESSOR 


A Word Processor is a very personal thing, 


#t4+4 by char/line 


Tt takes a while to get used 


One of the most useful facilities in Per- 
fection is that you can operate two docu- 
ment windows at the same time. You can 
quickly toggle between them to work on, 
say, the beginning and the end of your 
blockbuster at once. Only Perfection offers 
automatic page-diversion lines on screen. 


Page divisions 


The Editor does so only if you ask it to 
make a document of a file. Text87 shows 
page-divisions only if you ask it to Goto a 
page — though once you have done that, 
you can happily scroll through from one 
page to the start of the next. Itis quite easy, 
too, to find yourself dealing with some very 
odd page numbers; and it is quite hard to 
work out how to get them back to normal. 
There are, | feel, improvements that could 
be made in this area of the operation of 
Text87. 

WYSIWYG (what you see is what you 
get) is prized by writers laying out docu- 
ments. The Editor doesn’t have it. What- 
ever control codes you put in will stay there 
on the screen, taking up space and dis- 
torting the line lengths of whatever material 
you have typed in. 


WYSIWYG 


Text87 has WYSIWYG. Double height 
characters look it, and so do quad size. 
Compressed print looks squashed up, 
though not by much. Proportional print is 
presented proportionally on the screen. 
Italic usually doesn’t look italic in my setup, 
but could be made to do so. Bold is a 
different colour. Dif- 
ferent printer founts 
are notdistinguished 
by default, but there 
is acommand to At- 
tach screen display 
founts to different 
printer effects, and 
you can vary the 
number of screen 
display founts you 
use. Anyone with a 


gold card might be 
tempted to greater 
extravagance with 
memory. 
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Perfection is a kind of half-way house. 
Bold (or emphasised) print is a different 
colour on screen, and there are three dif- 
ferent strips which can be used for different 
printed effects. 

Different sizes of print aren’t shown ex- 
actly as they will appear, nor are different 
printer founts. Italics, unusually, do appear 
so, and there are also founts for subscript 
and superscript which are very realistic. For 
my money, text87 is the WYS!IW|Giest of 
the three programs, if WYSIWIGness is 
what you want. | think it is over-rated. Both 
Perfection and Text87 have clear ways of 
distinguishing a range of special effects. 


Printer drivers 


The Editor is distinct in having a sepa- 
rate printer driver. | could not be happy with 
it: it functions too much like a one-way 
escalator, and will not permit changes of 
mind, but it does, of course, work well as a 
printer driver. 

The Perfection driver functions from 
within the word processor, and has a brief 
interactive exchange before setting off. 
The driver is very complete, with up to 
sixteen translates which can be used for 
any printer features, such as different 
founts, double strike, or whatever, in addi- 
tion to a good range of standard features. 
Should you find that the whole battery of 
effects is insufficient, you can create sev- 
eral printer drivers, and load in whichever 
is most appropriate for specific needs. It 
would be possible to keep one for drawing 
neat IBM-style boxes, for instance — but 
you can only use one driver per printing 
session. Printing out something simple, 
such as a letter, has been made very quick 
and easy. 


Art of creation. . . 


As usual text87 adopts a different phi- 
losophy. You can create your own printer 
driver, but it’s not easy. Software87 obvi- 
ously don’t expect many users to do so, 
and instead provide an impressive battery 
of complete printer drivers. | use a Star XB- 
24, and have arange of about 200 typefaces 
to choose from. That seems a lot, but every 
variation, no matter how minor, is a differ- 
ent typeface — Courier 10 cpi is different 
from Courier Proportional, for instance. 
Annoyingly, | can Select only 10 of these at 
a time, and | have to re-select them every 
time | want to use the program: there is no 
facility for saving this selection other than 
as parts of an existing document, and | feel 
there ought to be. Perhaps this facility will 
be incorporated in a version 4 text87. Until 
then, you can get by with saving dummy 
documents incorporating the required 
typefaces. 

Although Perfection can be programmed, 
via the printer driver, to use a proportional 
font, it cannot produce a proportional 
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screen, nor can it automatically produce a 
fully justified proportional printout. The pro- 
gram always counts characters, not pixels. 
The manual suggests (p.23) that DP may 
get round to producing a module for pro- 
portional output eventually — a hint of Per- 
fection Super-Plus? Until that time, Text87 
is the only route to a really handsome 
proportional output with full justification. 


Home speed trials 


The speed at which a program works 
depends on extraneous factors like what is 
resident in the computer, its hardware 
configuration, how well it feels, and how 
well the user feels, as well as on intrinsic 
considerations. My timings are by stop- 
watch, in seconds, and very rough. These 
are not conventional benchmarks. Where 
a program takes varying times to performa 
task, | have given here an average. Where 
file operations are involved, the timings are 
for hard disk: 
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| guess — and the inability to save and re- 
load a selection of typefaces is a draw- 
back. The range of text-handling facilities 
is smaller than in the other programs — 
there is only one kind of search/replace, 
for instance. 

Perfection has, most of all, simplicity of 
operation, anda general familiarity for Quilll 
users. There is also the very valuable split 
screen, the convenient printer driver, user- 
configurability, the speed of many of its 
operations, the alternative of menu-driven 
or immediate commands, the good range 
of commands, and the intelligent file-han- 
dling operations. Perfection is a pretty as- 
sertive title, however, and as Mr Knightley 
says of Emmaat Box Hill, “Perfection should 
not have come so soon.” The program is 
still a bit raw in its version 2 state. The 
block-handling is — in my erratic hands 
anyway — unreliable; | think there must be 
easier ways to define a block. However, 
version 3 is on the market as we speak and 
most of the glitches (bugs is too strong a 
word) have been ironed out. 


Quill Editor text87 Perfection 

Execute program 10 5 9 4 

Load file 9 7 4 4 

Import file 51 rf 10 3 

Save file 7 7 Ss 2 

GoTo bottom/top 6 15 2 1.5 (long files, too) 
Move block 155(!) 18 17 25 

Replace string 48 13 12 20 

Reformat paragraph automatic 7 automatic 15 


All the timings are subjective. It would 
be fair to say that | am less familiar with 
Perfection than with the other programs, 
but | did try to live up to the advertising 
and do things fast. User input is most 
important in the block move operation, 
and the repeated string-replace opera- 
tion. Such operations are, in my view, 
easier in The Editor than in either of the 
other programs. 


Your excellency 


Each of these programs is excellent in 
many respects; none is perfect. | feel that 
The Editor offers the most trouble-free 
editing of text — which is what it is in- 
tended for. However, | dislike its printer 
driver, and instead use one of my own 
devising. Text87 offers a display which is 
pretty much as close as you can get to 
WYSIWYG, and has the advantage of 
allowing true proportional printout. The 
program allows a remarkable degree of 
user configuration. It also has complex 
printer drivers inbuilt, and includes the 
QJump spelling checker. Its disadvan- 
tages are lack of automatic page-division 
indicators, and the amazing manual. The 
screen which allows you to view the 
typefaces is not useful — it would take ten 
years to scroll through all those available, 


It is not easy to choose between these 
programs, so | shall continue to use all of 
them. For articles like this, The Editor is 
indispensable for the ease with which blocks 
of text can be moved from place to place, 
and for its fast reaction time. For producing 
semi-DTP-type material, | see no sensible 
alternative to Text87. But this is a program 
for people who are prepared to devote a lot 
of time to becoming familiar with its facili- 
ties. Perfection will be ideal for letters and 
documents. It will appeal particularly to 
those who want speed and simplicity of 
operation above all else. 


So what do you do? Well, it’s been said 
that changing your word processor is like 
ending alove affair. You wave goodbye to 
the time and emotion you invested — and 
then you have to start all over again. Mind 
you, itcan be like falling in love again. And 
do you choose simplicity, or the all-sing- 
ing, all-dancing sophisticate? They say 
‘wealth won't bring happiness, but it helps 
you to be miserable in comfort’. The same 
goes for a wealth of facilities. What about 
Quill users and Perfection? If you like the 
mother, you'll probably like the daughter 
— even if she seems a bit brainy to begin 
with. Trust your instincts — it's more fun, 
too. 
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Simon Goodwin presents fast QL code to compare 
decimals and search arrays. 


* OL WORLD DIY TOOLKIT - FAST COMPARISON FUNCTIONS 


* Versian G.7. 
* 


initialise lea.l 


movea.w 


jmp 
~ 


define,al 
$114.w,a2 
(a2) 


Copyright 1992 Simon N Goodwin. 


BP.INIF vector 


* MININT returns the lowest valid integer of an array or list 


* 
minint cmpa.1 
beq.s 
ber.s 
cmp.w 
ble.s 
move.w 
addq.1 
dbra 
move.w 
moveg 
moveq 
rts 


compare 
teo_much 
stack_int 


got_int 


* 


* Return constants —-32768 or +327467 


* 
lowest move.w 
bra.s 
lots move.w 
return_int moveg 
* 


*% Check there are Di bytes free for 


s 

stack _chk move.1 
movea.w 
jor 
movea.i 
suba.l 
move.i 
move.w 
subq.1l 
beq.s 
move.1 
bra 


stack_num 


* 


a3,as 
lowest 
get_ints 


#{a2,a6.1),0G 


toeo_much 
G{(a2,a6.1),d# 
#2,a2 

d3, compare 
d#@,@(ai,aé.1) 
#3, 04 

#0, dv 


#490909, d4 
return_int 
#&7FFF,d4 
#2,d1 


gdi,d7 
$11A.w, ad 
(ad) 

$58 (a6),al 
d7,ali 

ail, $58 (ad) 
d4,@(al,aé.1) 
#2,da7 
got_int 
d5,2¢(ai,aé.1) 
got_float 


Any parameters? 
If not, return —32768 


Is D® less than (A2Z,A6) 7, 
No, pick up the new lowest 
Stack the highest found 
INT result is stacked 
No error 
if there are no parameters 
MINIMUMZ is —32768 


MAX IMUMZ 
No. 


is 32767 
of bytes needed 


the result on the RI Stack 


Remember the space needed 
Read the BYV.CHRIX vector 
Check for Dil stack bytes 
Get a safe Al value 
Allocate the space 

Update RV.RIP 

Stack one word 

Is that enough? 


Stack, mantissa 


* MAXINT finds the highest valid integer it can 


* 
maxint cmpa.l 
beq.s 
bsr.s 
cmp.w 
bge.s 
move.w 
addq.1 
dbra 
braes 


compare4 


nat tep4 


move.l 
movea.1i 
moveq 
cmp.w 
bne.s 
lea.l 


FIND_ARRAY start with (A3,A6) —-> NT Entry, 


a3,a5 

lots 

get_ints 
@(a2,a6.1),d@ 
net_top4 
G(a2,a6.1),dd 
#2, a2 
d3,compare4 
stack_int 


$58 (ad) ,d7 
(a7)+,a4 
#2,d5 


#$G293,0(a3,a6.1) 


misc_ints 
get_ready,a5S 


Exit GAS with first word in D#@, 


ind_array movea.1l 
movea.l 
adda.il 
cmp.w 
bne.s 
mave.1 
movea.w 
jsr 
move.w 
subq.w 
bmi.s 
adda.l 
move.w 
adda.1l 


imp 
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4(a3,a6.1),a3 
4G (ad), a2 
a2,as 
#1,4(a3,a6.1) 
bad param 
dS,di 
$11A.w,a@ 
(a@) 
$6(a3,a6.1),d5 
#1,d3 

bad param 
@(as,a6.1},a2 
@(a2,a6.1),0@ 
d5,a2 

faS) 


(AZ, AS) 


Any parameters? 

If not, return +32757 
Put D3+1 params @ (A6,A2) 
Test one 


Pick up the new highest 
Advance to the next 


Return D@ to SuperBASIC 


Save BYV.RIP for later 

Tidy up return address 
Number of bytes per value 
Integer array? 

No, read integer parameters 
Continue there later 


DS = Element size 
—> the 2nd element 


AS => 
Fetch 


Array descriptor 
BYV.VVBAS offset 

A3 is descriptor AS offset 
Check mumber of dimensions 
Require just 1 dimension 
Ensure RI space for result 
Fetch BV.CHRIX vector 

No return if this fails 
Fetch maximum index value 
Prepare for DBRA later 
Require 2+ array elements! 
A2 is A& offset of values 
Fick up the first word 
Advance to the next element 








his month's listings introduce four 
simple functions and two new 
ideas: array parameters and fast 
floating-point operations. Array 
parameters allow tens or thousands of 
values to be processed by one resident 
procedure or function. Much more speed is 
attainable than when processing array el- 
ements one at a time in Basic. 

| also explain the organisation of Qdos 
floating point numbers, showing how 
knowledge of the format allows faster com- 
parisons than are possible with rom rou- 
tines. 

The new functions are called MAXIMUM 
and MINIMUM, with speedy integer 
equivalents MAXIMUM% and MINIMUM‘%. 
The effect depends on the number of pa- 
rameters you supply. Called without pa- 
rameters, the functions return the largest 
or smallest number that can be repre- 
sented, so MAXIMUM% returns 32767, 
the integer limit, while the floating-point 
MAXIMUM returns 1.61585 e616. Alterna- 
tively, you can pass the name of an array, 
and the function will scan all the values 
inside at great speed, returning the highest 
or lowest as appropriate. 

The most obvious case is when you pass 
a sequence of values, variables or expres- 
sions. The functions evaluate all the pa- 
rameters and return the value of the high- 
est or lowest. You may pass any number of 
parameters for comparison. 

MAXIMUM% (0,x%) returns X%, or zero 
if X% is less than zero. Such a call might be 
used to constrain pixel co-ordinates, 
avoiding an 'out of range' report. MINIMUM 
(a,Pl) returns either the value of A or 
3.141593, whicheveris the lowest. Without 
parameters MINIMUM% returns -32768, 
the lowest integer value. 

The functions are very fast when scan- 
ning large arrays, even in interpreted Ba- 
sic. The integer functions scan over 84,000 
values per second on my expanded QL, 
and floating-point comparisons run at 
24,500 per second. The routines in Listing 
one locate arrays for many other purposes 
besides finding maxima and minima. 

When used with no parameters, or alist of 
expressions, these functions should suit all 
known roms, compilers and emulators. 
There is no limit on the number of param- 
eters which may be supplied. 

The facility to pass an array parameter 
relies on the interpreter's Name Table and 
array descriptor system, documented in 
1985 by Jan Jones in QL SuperBasic, The 
Definitive Handbook. Array parameters 
work fine with Sinclair roms, Minerva, Thors 
and QLiberator tasks. 

Supercharge and Turbo work differently; 
the equivalent of the Name Table is half the 
size, and descriptors are rather more effi- 
ciently organised. Alas, array parameters 
are not supported, and there is no easy 
way to locate descriptors inside a task; you 
get a compile-time error report if you try to 
pass a compiled array to a resident func- 
tion. 

Listing 1 is the source code for the new 
functions. You can type this into your own 
assembler if you wish to re-assemble or 
modify the code, but you do not need an 
assembler to use the code as written. 

Listing two generates the code file di- 
rectly, reading the instructions from Super- 
Basic DATA statements. Lines 100 to 580 
of the loader are common to each DIY 
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Toolkit project. Lines from 590 onwards 


misc_ints movea.w #112.w,a2 Vector to get integers 


jsr (a2) CA. GTINT are specific to this project. | have experi- 
ERG: Se TENRF ERATE ae i mented with a faster, more friendly decimal 
Bai Bae rok Eeays (6% akvediy~ouses loader, but shall stick with hexadecimal for 
savin: GEisebe) de © Pick up the +irst integer the time being, after mixed reactions from 
mave. al,a2 
adda.1 d5,a2 Foint A2 at the next readers. 
get_ready movea.1 d7,al Retrieve old BV.RIP Note that you can change the names 
suba.l d5,al Make room for the result H 
move. 1 al, $58(aé) Set BV.RIP for later after the code file has been generated as 
jmp (a4) Return wherever well, using a binary file editor such as The 
* i i “ 
bad param moveg #-15,d@ RAD PARAMETER error Editor, Spy or Micro-Emacs. Just load the 
bad exit rts Return error cade in DS file, select 'overtype' mode, and type the 
a Eat ea ATH de lertg eee hte new name in capitals over the original 
get_ oats move. a . ave - or ater 4 s ° 4 
movea.l (a7)+,a4 Return point if all’s well before saving the new file. It IS Important 
maveq #6, d5 Allow six bytes per element not to change the length of the file or it will 
#¢$93G2,@(a3,a6é.1) Floatin oint array? 
pos Se ee ilies a not work thereafter. . 
lea. } get_mantis, aS Continue from here later The ALIAS command from DIY Toolkit 
r SESS Pure ies oY Volume A, allows you to give extra names 
misc_float movea.w $114.W,a2 Vector to get floats to_ any toolkit command or function. 
ioe a Sees CA. GTFP BPOKES FORGET_BAS, in Volume B, 
Subque 42,03 Gary 1 Wecantec? lets you discard resident names if they 
bmi-s  got_float clash with names in your existing Super- 
MmOVe.wW G$(ai,ab6.1),aa Pick up exponent Basic 
lea.1l 6falj),a2 Point A2 at the next ; I 
get_mantis move.1 -4(a2,a6.1),di Don’t forget the mantissa | shall continue to use the hex loader to 
; MRD Ore” generate stand-alone code, but | shall use 
* Find MINIMUM floating-point values constant, array or list faster decimal for composite programs, 
aries cmpa.1 a3,aS Any parameters? saa as 2 th at iy Bon er 
bne.s t_mini and read code from when used. 
saves #s0FFF,¢4 Exponent is 4995 decimal Assuming you specif MINMAX CODE as 
Bra eee ehR | MENIMOM in -iseieeS ania output from the hex loader, these instruc- 
dee a tions load the MAXIMUM and MINIMUM 
te yer ihe cae er os year “=? Ps, functions and link them to SuperBasic: 
compares or.s compare_fp Ss e& lowest 7 
bec.s net_least x=RESPR 448) 
move.w @(a2,a6.1),d@ Pick up the new lowest LBYTES mdv1 MINMAX CODE,x 
move. | 2(a2,a6.1),d1 exponent and mantissa CALL x ¥ he 
net _ least addq.1 #6,a2 Advance to the next one 
dbra d3, compares Try up to 45534 times The code and assembler source are 
t bra.s = stack_fp Put D®@ and Di on RI Stack available on disc or cartridge from DIY 
, Toolkit at Cwm Gwen Hall, Pencader 
* Find MAXIMUM floating-point values constant, array or list 3 3 
* Dyfed, Cymru SA39 SHA. Send £7 for DIY 
a ae Tee remat ae a Varna tere? Toolkit Volume 2, enclosing a microdrive 
move.w  #$0FFF,d4 Exponent is 4995 decimal cartridge if you do not have a disc drive. 
move.1 #$7FFFFFFF,d5 Mantissa has 7 hex *F’s Listing 1 includes full source code for the 
ae ae te” Pea o8 eee new functions. Much code is shared be- 
* x ; 
get_maxes Obsr.s get_ficsats Put BD3+i values @ (A2,A6) tween all four; for instance, they all return 
compare2 bsr.s compare fp = 4 via STK_CHECK if called with no param- 
bis.s net_top2 Skip if Z or € flag set d h iI FIND ARRAY if 
MOVE.w G{a2,ab6.1),0aH Pick up the new highest eters, an t ey all USE = | 
move. | 2{a2,a6.1),di Don’t forget the mantissa passed an array. GET FLOATS fetches 
i lia a hs Se ass floating-point values for MAXIMUM and 
* MINIMUM, whileGET_INTSdoesthesame 
stack_fp a Soe te the exponent for the integer functions. These routines 
move. i,Z{ai,aé&.1) tack the mantis . : 
got float moveg #2,04 Flag FLOAT Sea gear are shared In an unusual way which the 
moveq  #0,ao No error 68000 supports, but is more characteristic 
c nse of code for modern risc processors or 1950s 
* FAST F.P. COMPARE, sets C & Z for @..5(A2.A6) — D@.W DI-L computers without a 'stack'. 
* ; gle. ae. aan LBs GET_INTSandGET_FLOATSarecalled 
compare tp move. aZz,adé. . ick up next mantissa H H H i 
dead tase Copy the highesetrat with conventional BSR instructions, the 
sorel d5,d4 Do the signs match? equivalent of Basic's GO SUB, but both 
SPtrier ai Same iatgn Start by popping the return address into A4. 
tst.1 di No; is best yet -ve ? : 
inate (ho eed et This means the shared code can return 
add.1 4,4 Set Carry, since D&<@ errors directly to SuperBasic as if there 
3 ae was no intermediate call, performing RTS 
same_sign move.w @(a2,a6-1)}.d2 Pick up next exponent with the report code In DO. If all goes well 
ae Mo oo gees postive? the routines return with JMP (A4), and 
ee eee eee Coanare.antesettane ree there is no need to check the error code. 
bne.s compared Easy if they differ A similar but faster technique is used to 
are ee Ue SER CS ER eo invoke FIND. ARRAY, which may also need 
* to return an error code. The program points 
Heche insite meat tee - Compare exppomots 2 A5 at the target address, using a position- 
pig Ep pi see ee independent LEA instruction just before 
Ps di,d5 Mant lt ; 
/ rts a FIND_ARRAY is reached. _ 
oe Le ap i aoe This is faster because there is no need to 
ee 5" Four tong=¥kbed Eieeeine transfer the four byte return address to and 
de.w maximum—* from the A7 stack. The address register is 
higgé is eee used instead of the stack memory. Such 
«aW mini mum—* . . 
de.b 7, > MINIMUM? techniques gobble one address register 
dese matinee every time you use them, but they are 
| ee interesting and can be useful. 
de.b 8, *MINIMUMZ? Fast QL code minimises the number of 
= , bytes transferred to and from ram. The 
unexpanded QL is limited to about 860,000 


byte transfers per second; this doubles 
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DIY TOOLKIT 


QL World DIY Toolkit April 1992, Listing 2d: 

1@@ REMark Sinclair QL World HEX LOADER v 3 

11@ REMark by Marcus Jeffery & Simon N Goodwin 
15@ CLS: RESTORE : READ space: start-ALCHP( space} 


16@ PRINT “Loading Hex..." : HEX_LOAD start 
17@ INPUT "Save to file...";f$% 

182 SBYTES ft, start, byte : STOP 

198 : 


200 DEFine FuNection DECIMAL(x) 

2128 RETurn CODE(h$(x} )-48-7*(h$(x}>"9"} 
226 END DEFine DECIMAL 

ae .: 

240 DEFine PROCedure HEX_LOAD( start) 
298 byte = @ : checksum = @ 

3066 REPeat load_hex_digits 

312 READ h$ 

320 IF h$="*" : EXIT load_hex_digits 
338 IF LEN(h$)} MOD 2 


348 PRINT“Odd number of hex digits-in: ‘;h% 
358 STOP 

362 END IF 

372 FOR -b'= 1° TO’ LEN(HhS) STEP 2 

380 hb = DECIMAL(b} : 1b = DECIMAL(b4+1) 

390 IF hb<®@ OR hb>15 OR Lb<@ OR Ib>15 

4O@ PRINT’ Tllegal hex digit in: ";h$ : STOP 
429 END IF 

436 POKE start+byte, 16*hb+1b 

449 checksum = checksum + 16*hb + lb 

456 byte = byte + 1] 


462 END FOR b 
470 END REPeat load_hex_digits 

489 READ check 

499 IF check <> checksum 

5O2 PRINT“Checksum incorrect. Recheck data. °: STOP 
520 END IF 

538 PRINT’Checksum correct, data entered at: “;start 
56@ END DEFine HEX_LOAD 

570 : 

584 REMark Space requirements for the machine code 
590 DATA 448 

618 REMark Machine code data 

622 DATA "43FA@17E34780110", "4EDZBBCB671C6162" 

632 DATA “BO72E8@O06F043032", “EBOOS54BA5D1CBFFF2" 

640 DATA "“3S38GE8O0078037000", “4E7T5383CBGGG6004" 

652 DATA “383C7FFF72622E31", "3078G11A4E96226R" 

668@ DATA “@45893C72D490058", "3384ER800558767D4" 

672 DATA "238588027802 7080", “4E75BBCB67D26112" 
680 DATA "BO?7Z2E80@6CG43632", “HBOG5S4BA51CBFFF2" 
690 DATA “8@AEZEZE@O5S8285F" , “OC730303EBO0662E" 
706 DATA “2673E894246E0028", 'D7CABC7TSOOBLESB4" 
71G DATA “663C072623078611A", “4E9903633E8465543" 
726 DATA "“6B2CDSF3E8963032", “EBG@0548A66163478" 


738 DATA “91124E92661A5543", "6BOSFFEA3O31EBOO" 
748 DATA “45E99@00222475589", “2D4900584ED470F 1°" 
750 DATA "4E75BBCBE6GE383C", “OFFFZA3CBOOGIOAG © 
760 DATA "6O@OOFF546126616E", "64083032E8O02232" 
770 DATA “E8@25C8A51CBFFFS", "6S4EBBCB6636383C" 
782 DATA "@FFF2A3C7FFFFFFF", “680GFF2C2E2 E0058" 
796 DATA °"285F347801144E92", "66B655436B323931" 
806 DATA "E8@@2231H8G245E9", "P@GBE22475D892D49" 


810 DATA "@@584ED461D6611E"., "63883032K8002232" 
820 DATA “E8@25C8A51CBFFFO", “338GE8002381E8G2" 
838 DATA "788279004E752A32", "EBO228G91 BBB 46A68 " 
846 DATA "4A816B12D8844E75", "3432E8604A8 56B48" 
850 DATA "B4496602BA814E75", "BO4266FABA814E75" 
860 DATA "SOBAOPOOSGOOSFF74", "O74D4158494D554D" 
870 DATA "“FF42074D4948494D", "554DFEC@@84D4158" 
880 DATA “494D554D2500FE64", "O64D494R494D554D" 
B96 DATA "2588OA00".° *’ 48383 
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with rom or fast ram expansion. 

You may be surprised to see the value 5, 
rather than 4, before the table of function 
names and addresses. The average length 


“of names is more than the default maxi- 


mum of seven, so an extra eight bytes of 
Name List space may be needed; you tell 
BP.INIT about this by adding one to the 
function count. Each unit expands the 
Name Table and Name List by eight bytes. 

Whena SuperBasic array is dimensioned, 
the interpreter allocates memory for the 
elements in the Variable Values area. It 
also creates a ‘descriptor’ which describes 
the shape and location of the array in 
memory. The routines check the Name 
Table entry for the first parameter. If itis an 
array the Table holds $0303 for integers, 
or $0302 for floating-point values. The 
dollar sign indicates the hexadecimal no- 
tation, base 16, which was used to design 
the Name Table. The third possibility is 
$0301, for a string array. 

The second half of the Name Table entry 
holds a long word, the offset of the array 
descriptor in the Variable Values area. 
SuperBasic locates each array element by 
looking up the array name in the Name 
Table, then finding the descriptor, which 
contains information needed to locate the 
elements themselves. 

The size of an array descriptor depends 
on the number of dimensions. The mini- 
mum is ten bytes, for a one-dimensional 
array, and rises by four bytes for each 
additional dimension. The first long word 
of each descriptor points to the elements. 
It holds an offset relative to the start of the 
Variable Values area. All other values are 
16 bit integers. 

The next word holds the number of di- 
mensions, followed by a pair of words for 
each dimension. The first word in each 
pair indicates the maximum subscript value 
for the dimension, and the second holds 
the distance between elements of this 
dimension, in units of one element: six 
bytes for decimals and two for integers. 

DIM S$(10) generates the offset, fol- 
lowed by 1, the number of dimensions, 10, 
the maximum subscript and 1, using one 
byte per element. DIM A(10,10) follows 
the offset with 2, 10, 11 (remember element 
zero!), 10 and 1. 

DIM X(1,1,1) gives a three dimensional 
array, with descriptor words 3, 1,4, 1,2, 1, 
1. The interpreter treats element zero of a 
string array as the two-byte string length, 
so DIM S$(10, 10) stores descriptor val- 
ues 2, 10, 12, 10 and 1 after the offset of 
the elements. 

Array elements are stored sequentially, 
with the last subscript varying most quickly, 
so that DIM X(1,1) allocates space for 
X(0,0), X(0,1), X(1,0) and X(1,1), in that 
order. 

As presented, the MINIMUM and MAXI- 
MUM routines expect lists of values or 
one-dimensional arrays, butthe code could 
be extended to process any shape of 
array, even a selected slice. The DBRA 
must be replaced with a long count in D3 
if you need more than 65537 elements. 

The CA.GT parameter routines lines up 
values on the RI Stack just like array 
elements. The same routines can scan 
either, once A2 holds the offset of the 
value. All the functions start by picking up 
the first value, and compare it with each of 
the others in turn. If you only supply one 


Sinclair/QL World April 1992 


parameter it is returned at once. 

The functions report Bad Parameter 
(ERR_BP) if you pass them too many di- 
mensions, the wrong type of array, or an 
‘array’ with only one element. The type of 
the array should match the type of the 
function, be it integer or floating-point. 

The 32 bit registers in the QL can store 
whole numbers in the range -214748368 to 
214748367. The 68008 and 68000 need 
combinations of instructions to manipulate 
numbers outside that range. The QL rom 
floating-point arithmetic can handle num- 
bers in the range +/- 1.61585 e616. 

The'e' indicates that the following number 
is a count of decimal places, or exponent; 
the QL exponent allows a mind-boggling 
616 digit places before and after the deci- 
mal point, but the 32 bit mantissa is only 
accurate to about nine decimal digits. 

Exponent and mantissa are stored in bi- 
nary. The exponent is a word between 0 
and 4095, and indicates the position of a 
binary point in the mantissa. To double the 
overall value, add one to the exponent. To 
halve it, subtract one from the exponent. 

INPUT (on Minerva 1.64) limits the expo- 
nent to 4094, so you can PRINT numbers 
twice as great as youcan enter. The JMrom 
INPUT routine does not have this restric- 
tion. PRINT is slow on extreme values, 
because it performs repeated floating-point 
multiplication or division by ten to get the 
number into range. 

The mantissa holds in 31 bits the binary 
digits of the value. The most significant bit 
is the sign, using two's-complement arith- 
metic, with the most negative number com- 
ing after the most positive, as is the case 
with signed 16 bit integers. 
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EEC LTD THE WORLD'S LARGEST QL RETAILER 
The expandable system for businesses, beginners and experts. 
COMPLETE QL's - JS ROM - BRAND NEW PRODUCT- 6 MONTHS 


GUARANTEE 


Package includes PSU, TV Lead, OL Software 2.35: Quill - Wordprocessor, 
Abacus - Spreadsheet Archive - Database & Easel - Business Graphics, 


Comprehensive instruction manual. 


One year’s free membership to QUANTA - the independent user group who 
provide help, newsletters & a library of 400+ programs - mostly free. 


BARGAIN PRICE MONITORS All prices include 17.5% VAT 


To keep your costs down, the price you see is the price you pay - 
WE HAVE BEEN SEARCHING FOR A HIGH QUALITY QL MONITOR 
* FOR A LONG TIME, WE THINK THE GOLDSTAR IS THE ONE! 


OFFER I - colour 


GOLDSTAR 14" Hi-Res with 0.31 dot pitch in stylish grey 
non glare screen (also O.K. for PCs) (Tilt & Swivel base £5) 


OFFER 2 - colour 


Philips 8833 Mk II - a lower resolution monitor than the GOLDSTAR 


but with stereo sound capabilities. 0.42 Dot Pitch. 
OFFER 3 - Mono-DIGIVISION with OL Connector 
12" Green Screen monitor, 2 Colour case 


QOL TO PC KEYBOARD ENHANCEMENTS 


UK version, - £35 
OL/PC keyboard interface - £75 External fitting box & cable - £17 


OL/PC 102 keyboards - £25 





The Mantissa of MAXIMUM is 
$7FFFFFFF, with all bits set except the 
sign, while the mantissa of MINIMUM is 
$80000000, with only the sign bit set. The 
tiniest possible number has an exponent of 
zero and a mantissa of one, giving a value 
of 1.440917 e-626. It will be ignored if you 
add it to any number that is not similarly 
infinitesimal. You get a curious ‘overflow’ 
error if you try to INPUT such a low value, 
on JM and JSL1 alike. 

Normally (sic) the most significant bit of 
the mantissa is shifted all the way to the left, 
with corresponding adjustments to the ex- 
ponent, in which case it is said to be 'nor- 
malised'. This preserves nine digits of ac- 
curacy and means there is just one repre- 
sentation for each value. 

If values have different exponents, float- 
ing point addition and subtraction start by 
sliding the lesser value to the right till the 
exponents match. Then they work out the 
answer, accurate to 32 bits, with one long 
integer instruction, and shift the value back 
to the left if necessary. These shifts may 
lose some or all significant bits, which is 
why PRINT 1+1e-7-1 gives 9.965152E-8. 

That's good enough, to 32 bit accuracy. | 
explore the issue of floating point precision 
in more detail in the extra documentation 
for DIY Toolkit Volume Z. 

The SuperBasic interpreter naively com- 
pares floating-point numbers by subtract- 
ing one from another and testing the sign of 
the result. The subroutine COMPARE_FP, 
near the end of Listing 1, is much faster. It 
can compare two floating-point values and 
indicate the greatest in between seven and 
eleven machine-code instructions, de- 
pending on the values. 
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NEW! 196 


NEW! 


£49 


GRAPHIX DEMOS DISK 1,3,4 


C.G.H. SERVICES 


Cwm Gwen Hall, Pencader, Dyfed, Cymru, SA39 9HA 
(Tel. 0559 384574) (9am - 5pm) 


AND SHAREWARE LIBRARY 
ALL DISKS £2.00 EACH INCLUSIVE OF MEDIA AND P&P 


ADVENTURE GAMES DISK 1 (includes Fantasia and Ye Classical Type Adventure) 
ADVENTURE SOLUTIONS DISKS 1-3 (includes The Pawn and Mortville Manor, mainly ST) 
ADVENTURE SOLUTIONS DISK 4 (QL specific) 

ADVENTURE GAMES SOURCE CODE DISK 1 (includes Fantasia, Haunted House, etc) 
ADVENTURE UTILITIES DISK (includes Quill to SuperBasic coverter and demo adventure) 
AUSTRALIAN P.D. DISKS 1 + 2 (includes a wide variety of games, utilities etc) 
COMMUNICATIONS DISK 1 (includes QBOX Bulletin Board system) 

COMMUNICATIONS DISK 2 (includes QL Kermit) 

CONNECTIONS DISK 1 (includes ST - QL screen and file converters) 

DEVICE UTILITIES DISK 1 (includes archiving, compacting, formatting and Shell programs) 
DILWYN JONES DISK 1 (includes many SuperBasic progs and Wordsearch) 

EDITORS DISK 1 (includes QED and MicroEmacs) 

EDUCATIONAL PROGRAMS DISK 1 (includes maths, music and chemistry programs) 
EMMANUEL VERBEECK DISK 1 (includes screen save and print progs, and many more utilities) 
ESOTERICA DISK 1 (includes DIY Pyramid construction prog. Biorythms and Psychology progs) 
FRACTALS DISK 1 (includes large numbers of mandelbrot and other fractal progs) 
FRACTALS DISK 2 (Carl Cronin's mandelbrot prog plus animation screens) 

FRACTALS DISK 3 (Rainer Kowallick's mandelbrot prog as amended to give "Jewel" effect) 
GAMES DISK 1 (includes Starburst, Cavern Frenzy) 

GAMES DISK 2 (includes many arcade type games) 

GAMES DISK 3 (includes QL War) 

GERMAN TO ENGLISH DICTIONARY (multi-tasking) 

GRAPHIX ANIMATION DISKS 1,2,3,4,5 (TV Movies) 


GRAPHIX SCREENS (GIF FORMAT) DISKS 1,2,3 

GRAPHIX SCREENS (PIX FORMAT) DISK 1 

GRAPHIX SCREENS (SPECTRUM) DISK 1 

GRAPHIX SCREENS (ST) DISKS 1,2,3,4,5,6,7,8 

GRAPHICS/SCREEN UTILITIES DISK (includes sprite designer. CAD and window progs.) 
HAM RADIO DISK 1 (includes PC conversions) 


DIY TOOLKIT 


For even more speed, at a cost of about 
30 bytes, remove the BSR.S and RTS 
instructions and write the routine out twice, 
in full, at COMPARE2 and COMPARES. 
This makes more difference than you might 
expect as BSR and RTS are comparatively 
slow. They must transfer four bytes to or 
from the A7 stack, and discard the next 
partly-decoded instruction in the 68008 
pipeline. 

COMPARE_FP compares a value in reg- 
isters DO and D1 with a value in memory, 
addressed by offset A2 on A6. The offset is 
vital when the value is inside the SuperBa- 
sic memory area, which could move, taking 
A6 with it. DO.W contains the exponent, 0- 
4095, and D1.L holds the 32 bit signed 
mantissa. The routine uses D2, D4 and D5 
internally, sparing D3 as that is the count of 
values to be scanned. 

The routine looks at each part of the value 
in turn, trying to determine which is the 
highest. It masks the two mantissae to- 
gether to compare their signs. If EOR (ex- 
clusive OR) leaves a negative value, the 
signs differ and the result is obvious. Other- 
wise the exponents are compared to see 
which is the highest; if they match, the only 
difference is inthe mantissae, which can be 
compared directly in D1 and D5. 

The result is indicated by the carry flag C 
and zero flag Z. C is set if the registers 
exceed the value in memory. Zis set if both 
values are the same. MAXIMUM uses the 
BLS instruction after the call to keep the 
same value in the registers if either flag is 
set. MINIMUM uses BCC, fetching a new 
lowest value unless carry is clear, indicat- 
ing that the memory value is less than that 
in DO and D1. 





PUBLIC DOMAIN 


PRINTERS Centronics - Serial Interface £27 if reqd. Ml prices include 17.5% VAT 


Olivetti/TA dot matrix, up to 200cps/30 NLQ, FX850 emulation - £129 
Canon BJ10ex bubblejet, very high quality (360 dpi), A4 size - £259 
OKI microline, ML183, wide carriage dot matrix printer - £129 

We can supply any make/model printer - please ask for details. 


INDEXES DISK 1 (Quanta and QL User/World) 

MATHS DISK 1 (includes calculator, Pi and calendar creator progs) 

MONEY DISK 1 (Capital Gains Tax and Simple Book Keeper) 

OLIVER FINK DISK 1 (includes progs requiring Pointer environment to work) 

PRINTER UTILITIES DISK 1 (includes label creators and printer tutorials) 
PROGRAMMING DISK 1 (includes QL PROCOG) 

PROGRAMMING DISKS 10-18 (Release 2)68 Compiler 

RALF BIEDERMANN DISKS 1 + 2 (excellent collection of programs, games, utilities, etc) 






















RECREATIONAL MATHS DISK (includes life cellular automatons etc) 
SUPERBASIC UTILITIES DISK 1 (includes large numbers of utilities progs, toolkits, procedures, etc) 
TEXT DISKS 1-7 (The Bible - Old Testament) 

TEXT DISK 15-16 (The Bible - New Testament) 

TEXT DISK 14 (400+ Business Letters from U.S.A.) 

TYPING TUTOR (Artip - Touch typing tutor) 

THOR DISK 1 (Collection of Thor compatible programs) 

Please note the above are only part of our P.D. Library. New programs are constantly being added and more are always 
welcome. Please send an SAE for full catalogue. We can also supply commercial software for STs and Amigas! 

ALL PRICES INCLUDE MEDIA AND POST AND PACKING FOR THE UK. PLEASE ADD 10% FOR ORDERS IN EUROPE; 
20% OUTSIDE OF EUROPE. PLEASE INDICATE 3.5'/5.25" VERSIONS WHEN ORDERING. 


OL/Spectrum spares & repairs - please ask for details 


EEC LTD Payment terms: 


18-21 MISBOURNE HOUSE CWO, Access, VISA et cetera 
il . - allow I 
CHILTERN HILL, Cheques - allow 10 days 


Delivery: 

CHALFONT ST PETER, é 

BUCKS Carriage - £9 Postage - £3 
SLO QUE Product subject to availability. E&OE. 


Tel: 0753 888866 Fax: 0753 887149 
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Rich Mellor 
tests two rare 
programs for 
disassembling 
machine code. 





ver since computers 
were first invented, 
they have worked in 
machine code which in 
its native form (a series of bi- 
nary digits) is nigh impossible 
to understand or program. Be- 
fore the advent of Basic, 
assembly language (which uses 
a series of mnemonics to repre- 
sent the computer’s internal 
codes) was invented. This was, 
and still is, a sort of halfway 
house, where a mnemonic rep- 
resents a specific instruction 
that the computer has to carry 
out, in direct contrast to high- 
level languages such as 
SuperBasic. 

In a high-level language, you 
can tell the computer to PRINT 
something and it will then carry 
out the hundred or so single 
instructions it has to perform 
to take the character you have 
given it, convert it into the nine 
lines of pixels which make up 
the character and chosen ink 
colour, calculate where the 
characteris toappear onscreen, 
then poke the necessary values 
onto the screen; whereas it is 
up to you to do all of the work 
in machine code. 

Although the QL’s operating 
system Qdos has thankfully 
provided machine code pro- 
grammers with sets of useful 
routines. if you have ever tried 
to program in assembly lan- 
guage you will know how 
difficult it is to learn. 

Arguably, the best way to 
learn machine code is to take 
other people’s programs and 
try to adapt them to suit your 
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ER SF ets Fz OSA 80 1990 SSSI: STATUS 


F? OSA 8. 19) SSE: 


a oi dc.| prel arel defp text code ascii F3 LOAD F4 SAVE FS F ail 
Filetype: @ 


¥ OISR - LISTING: flp2_font_ext 
A ERRORS = SER 
DATA 8 


EWU t 
LEA LBBBA Al 
MOVER.) = $88008118 AZ 
Je tA) 
OC $0081 
OCW Law1o-¢ 
Of. $86, S_FONT’ . $08 
OP $8808 
BC SH008 
DC .W SHH 
BSR.S LAB? 
PNE.S LBaKO 
BSE.3 LOB3E 
‘UBA.L AZ AZ 


* BP_INIT 





Figure one: an example of DISA at work 


needs. However, once you have 
read articles in magazines and 
tried to alter machine code, you 
begin to realise that if you are 
to take machine code program- 
ming seriously, you not only 
need an assembler to convert 
assembly language into ma- 
chine code, but you also need a 
program which works the other 
way around, converting the 
numbers which form machine 
code into the original assem- 
bly language (the source code). 
This is useful if you ever lose 
source code, or wish to see how 
a certain toolkit extension 
works. 


Assembly 


A program which converts 
machine code into assembly 
language is called a 
disassembler. The OL has not 
been blessed with many dedi- 
cated disassemblers, and there 
are mainly only monitors/ 
disassemblers on the market, 
such as Qmon II. Although this 
type of program is very good 
for debugging your own soft- 
ware, it can be a pain if you 
want to create source code for 
a program which you do not 
know in great depth — Figure 
Three shows an example of its 
output. Once you have the out- 
put froma program like Qmon 
II, you will need an editor to 
strip away the unwanted loca- 
tion numbers (the first column); 
to remove ‘opcodes’ (the fig- 
ures in the second column); to 


make sense of lines like the 
second and third lines; and to 
convert some of the addresses 
into labels (where the machine 
code refers to itself). These two 
recent releases from the Conti- 
nent are aimed at making 
disassembly much easier. 

DISA, published by Jurgen 
Falkenberg, is described as a 
disassembler with an intelli- 
gent editor. What this means is 
that you have total control over 
the output of the program, but 
in an interactive way. 

The program relies on the 
QJump pointer interface to cre- 
ate a friendly operating 
environment. Although the lat- 
est versions of the pointer 
interfaceand window manager 
are supplied on the disk, I was 
rather disappointed that the 
user is assumed to know how 
to install this and then call the 
main program, because no boot 
program is provided. A small 
boot program would have been 
a great help, especially since 
the pointer interface files have 
to be loaded in a certain order. 

Once and the main program 
is loaded, the user is presented 
with the main screen which has 
the pointer on top of the LOAD 
command. Pressing space or 
enter goes to a sub-menu from 
where you must enter the name 
of a machine code file to load 
(no directory is available — but 
the pointer interface soon lets 
you do a directory from 
SuperBasic/Qpac2), or the start 
address of machine code in 
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INFORMATION 

Program: DISA 
Disassembler (1.0) 

Supplier: Jurgen Falkenberg, 
Computer 
Technik, Thanweg 
36,7536 ERSINGEN, 
Germany 

> 256K 


69 DM (approx 


£30) + 15 DM p&p 
(3.5" Disk Only) 


: DEA Disassembler 
(v4.07) 

: ErgonDevelopment, 
c/o Davide 
Santachiara, Via 
Emilio de Marchi 
n.2, 42100 Reggio 
Emilia, Italy. 
£29 + £5 p&p 
(payable to D 
Santachiara. Add 
£4 for sterling 
cheques; 
nothing for Euro- 
cheques in Lire. 





memory. Once the file has been 
loaded, the program sets up an 
index of all of the different flags, 
labels and other internal infor- 
mation which DISA uses to 
access different parts of the 
machine code program quickly 
as it is disassembled. 

Once the file has been loaded, 
the main screen is split into 
four columns. The first column 
is empty on start up and its use 
becomes apparent once you 
start to disassemble the ma- 
chine code. The second column 
contains the offset of each in- 
struction line from the start of 
the code. ‘L’ appears in front of 
some of these offsets to show 
that they are in fact labels re- 
ferred to elsewhere in the 
source code (eg program 
branches). The next column 
contains the bytes which make 
up each instruction (the 
opcodes), and the final column 
contains the assembly lan- 
guage instruction itself (if it 
makes sense). 

You must now proceed to 
scroll down the listing and de- 
cide where the machine code 
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type alters from ‘code’ to ‘data’, 
‘definition block’, or ‘text’. At 
the start of each block type, 
you will need to choose the 
relevant type and then assign 
it to the line. At the top of the 
screen appear the different 
code types, which you can ei- 
ther select by moving the 
pointer on top of them and 
pressing space, or by pressing 
the letter which is underlined 
in respect of each type. You 
then assign the type to a line of 
machine code by moving the 
pointer onto the line and press- 
ing Enter. The chosen type 
appears in the first column 
against the given line. This does 
not take as long as you would 
think, since you only need to 
specify the lines where the code 
type alters. Pressing F5 to go to 
the Editor window will check 
that you have assigned the cor- 
rect code type (this window 
displays the output of the pro- 
gram as it will appear in the 
final listing). 


Scroll 


If the chosen code type is a 
definition block or text, the pro- 
gram will earmark where the 
definition block or text ends as 
a final check that you are using 
the correct codetype. Although 
the definition block will auto- 
matically spot if the block is a 
Basic (BP_INIT) list, rom 
header, Thing header, or Optr 
Config block; I was disap- 
pointed that the Text code type 
only copes with text where it is 
preceded by a word length 
(byte length text is also quite 
common). 

Because the changes in code 
type are unlikely to fall at the 
start of each line on the dis- 
play, you are able to split lines 
onthe screen ona word bound- 
ary. This is much simpler than 
the manual seems to suggest, 
in that you merely need to press 
Space (the line under the 
pointer will turn green), and 
then slide the pointer along the 
opcodes, until a box appears 
with a little arrow pointing 
downwards. Pressing Enter 
while this box is displayed will 
perform the split (a similar 
operation is performed to join 
lines together, although this 
only works with lines which 
have previously been split). 

Other commands to help you 
to sort out the machine code 
program include setting byte, 
word or longword length data, 
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Figure two: DEA working through the code 


declaring address or PC rela- 
tive pointers and setting 
markers. 

I was a little confused by the 
manual’s explanation of mark- 
ers, untill realised that youcan 
set markers relatively easily by 
pressing Space on a line in the 
listing, then moving the pointer 
onto the Code-Offset and press- 
ing Enter. Once a marker has 
been set, you can jump to the 
next marker by switching to 
the Editor mode (press F5) and 
press Enter in the middle of the 
window. These markers are 
useful for navigating about the 
listing as it is produced. 





Navigation about the disas- 
sembly is a little complicated, 
because the scroll bar in the 
main window does not have 
any effect. Instead you can 
scroll up or down by a page or 
by a line at a time, or you can 
switch to the Editor mode, 
move to the desired position 
and then return to the main 
window (pressing F5 or Space 
onthe Editor command retains 
your position in the listing). 
Oddly, in the Editor mode, the 
scroll bars work fine, but there 
were two problems with navi- 
gation here, in that if you went 
to the start of the listing (when 
disassembling a file loaded 
from disk), the top of the scroll 
bar went to somewhere slightly 
above the start of the listing 
(printing rubbish on the 


Sinclair/QL World April 1992 


168 Log: 16000 
Ui EEO I 


BY * = 
ak Code execution starts at $10008 With LB 


from 18800 to 13 


from 1484R to 18 : 





Last: BIGOA? Off: 


iF :0 bs 
Nem : 20252 TK ie at 


screen); and you are unable to 
move backwards througha list- 
ing other than by using the 
scroll bars. 

You can save your work at 
any time together with the in- 
dex information to date, but 
once you have completed 
working on your listing, you 
can prepare it for subsequent 
loading into an assembler. 

The F1 (Status) window al- 
lows you to dictate remark 


. characters; whether or not ad- 


dresses are listed together with 
(PC) after them; whether Odos 
or SMS2 trap/vector names are 
displayed by the program; 


DISAGDEA 


whether the output is in 
Capslock or not; and whether 
or not conditional branches are 
shown indented in the listing. 
You are even allowed to insert 
two assembler directives in the 
header. 

DISA then quickly proceeds 
to print out the listing to your 
chosen device. I liked the pro- 
gram’s final output, which 
displays the names of all vec- 
tors, Traps and Error codes 
used by the machine code (as 
remarks). The assembler direc- 
tives are useful, but I still found 
that for the MetaComCo as- 
sembler, I needed to delete the 
DATA directive at the top of 
the listing (this cannot be al- 
tered to a remark line without 
a separate editor). The output 
was clear, and thankfully, 


SOFTWARE FILE 


when run through my assem- 
bler, produced the same 
machine code as the original 
file. 

Overall, the program is very 
useful and provides an excel- 
lent means of controlling the 
disassembly of a machine-code 
program with ease. Unfortu- 
nately the documentation 
leaves something to be desired 
—a little more information on 
setting the program up in the 
first place and using the pointer 
system would have been a big 
help. The config program is 
included to allow you to 
configure DISA (you can 
mainly alter the defaults in the 
F1 Status window), but there is 
nothing in the documentation 
concerning its use apart from 
telling you that it is supplied. 

DEAssembler (DEA) — pub- 
lished by Ergon Development, 
is aimed at a slightly different 
market to DISA, since it will 
‘automatically’ produce a dis- 
assembly of the specified 
machine code. This program 
will appeal to those less well- 
versed in machine code since it 
does not require as great an 
understanding of the program 
to be disassembled as DISA. 


Manual 


The programis supplied with 
a sizeable A4 printed manual, 
which goes into some depth to 
introduce the program and the 
idea behind an ‘intelligent 
disassembler’. The manual 
supplied for review was diffi- 
cult to understand in places 
due to the translation from Ital- 
ian to English, but I have been 
informed by Ergon that they 
have asked someone in the UK 
to improve the manual. 

The program is written in 
Turbocharged SuperBasic and 
loads quickly fromthe supplied 
boot program, presenting the 
user with an initial menu to 
load machine code from a file, 
from memory or from the rom 
socket. Selecting ‘file’ allows 
you to enter a filename, al- 
though entering ‘flp1_?’ will 
produce a directory of flp1_so 
that you can remind yourself 
of the name of the file. 

The program is operated by a 
menu system developed by 
Ergon themselves, based onthe 
QJump Pointer system menus, 
but can be used by a program 
compiled with Turbo. The 
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menus each have a cursor bar 
which can be moved up or 
down onto the desired option, 
as well as letters against each 
option, which allow you to se- 
lect an option by pressing the 
relevant key. As with Qptr, 
pressing Space will select an 
option pointed to by the cursor 
bar and on most menus will 
actually carry out the option. 
However, some menus are 
specified ‘multiple option 
menus’, whereby the desired 
options must be chosen using 
the cursor bar or option keys, 
and then Enter pressed to carry 
out the function itself. 


Smoothly 


The menus operate extremely 
smoothly and make the pro- 
gram very easy to use for 
everyone (not just those used 
to Qptr) — the manual goes into 
some depth to explain the use 
of the menus and how to oper- 
ate the various options. 

Once you have specified the 
machine code to be disassem- 
bled, the range of options 
presented to the user seem mys- 
tifying. However, generally the 
main option required by the 
user first of all will be ‘global 
parsing’. When selected, DEA 
will go through the machine 
code and follow each branch, 
allocating a label as it 
progresses. The user can select 
whether or not to watch DEA 
as it processes the machine 
code, as well as selecting the 
degree of automatic decision- 
making which DEA can make. 
This process is quite fast, with 
DEA automatically spotting 
definition tables and headers. 

The progress of DEA is shown 
graphically at the bottom of the 
display in a ‘pixel map’ which 
turns green as more of the pro- 
gram is disassembled. Once 
DEA has followed all of the 
program’s branches and main 
code, it will then look through 
the machine code for either byte 
or word length strings, either 
automatically selecting them or 
asking for confirmation by the 
user as specified. 

In stage 3 of the parsing the 
user has to be involved. This is 
where DEA attempts to look at 
any labels which it has allo- 
cated but which are not 
necessarily branches of the ma- 
chine-code program. Again the 
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user can decide upon the de- 
eree of automation, but will 
generally have toselect the code 
type relevant to each block of 
code (you select this from an- 
other menu). This process can 
take time depending on how 
the machine code program has 
been written, as well as its 
length, but DEA places the cur- 
sor bar on what it considers the 
most probable selection for the 
given block of code. I was a 
little disappointed that there 
was not an option for a ‘trial’ 
mode here, since it is too easy 
toidentify something asa block 
of machine code when it is in 
fact a block of data. 

DEA will then continue to 
parse these code blocks as far 
as possible, generally decod- 
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disassembled, you can request 
DEA to produce the final list- 
ing. Thisis doneina form which 
can be re-assembled without 
any alterations — the user can 
specify the character for Re- 
marks, whether (PC) appears 
in the listing, and thenameused 
for labels. You can decide 
whether or not to include code 
which has not been disassem- 
bled (data), or whether to 
include the Ascii equivalent for 
such code. The listing itself is 
then easy to follow, with dif- 
ferent code blocks clearly 
marked (together with the off- 
set from the start of the 
program). 

Overall, the program is easy 
to use and has many features to 
examine different parts of a 
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Figure three: A sample printout from QJump’s Qmon. 


ing around 80% of a large pro- 
gram without any intervention 
by the user. 

If you are disassembling a 
large machine code program, 
you may find that the dataspace 
set aside to store the labels and 
blockinformation becomes full. 
However, DEA spots this and 
will ignore branches to other 
parts of the program until it 
has more space available, 
whereupon DEA will return to 
those parts which it had to ig- 
nore. As with DISA, the 
disassembly may be saved part- 
way through processing so that 
it may be resumed later. 

Once the main section of pars- 
ing has taken place, DEA 
dumps the areas which have 
not been looked at, so that the 
user can look for the start of 
any new blocks of code which 
the program has missed. 

Once you are satisfied that 
the machine code has been fully 


machine code program. The 
options available to the user 
are various and help to make 
program disassembly quick 
and easy, although the defaults 
which are selected by the pro- 
gram are generally intelligent 
enough to allow even the least 
experienced machine code pro- 
grammer to obtain a source 
code for simple machine-code 
programs. 

One extra feature of the pro- 
gram isa ‘keywords manager’, 
which allows the user to ex- 
tract certain keywords from a 
toolkit. Unfortunately this part 
of the program is not too easy 
to master, as it is difficult to 
specify keywords which are 
already linked into the QL’s 
memory unless you know 
where they are located. This 
feature, once mastered, can 
provide Users with a useful 
means of extracting commands 
from toolkits for their own use, 


although it should not be used 
as a means-of breaching copy- 
right. 

I liked the way in which the 
program was controlled, and 
especially the fact that the user 
could specify an assumed start 
address for the machine code, 
which allowed DEA to disas- 
semble an address dependent 
program in memory with ease. 
The labels attached to the dis- 
assembled program are then 
relative to this assumed start 
address, enabling the user (with 
a little work) to transform the 
machine code into address in- 
dependent code which can be 
run with LRESPR. 

The ability to decide the de- 
gree to which DEA can make 
decisions about the machine 
code program is something 
which is essential to this type 
of program and something 
which a rival program, IDIS 
Special Edition, sorely lacks. This 
program is certainly the most 
versatile machine code pro- 
gramming utility I have seen 
on any computer to date. 

As a test for the relative mer- 
its of the two programs, I used 
a short (168 byte) machine code 
toolkit extension that I had writ- 
ten some time ago. Both DISA 
and DEA enabled me to obtain 
the original source code with- 
out much trouble, although 
DEA did not actually need me 
to intervene in the disassembly 
at all. 

I preferred the final output 
from DISA because of the 
added remarks stating the 
names of Traps and Vectors 
used by the program. The in- 
dentation for conditional 
branches together with the 
tabulated print-out, helped to 
make the final listing more 
readable, but this was a little 
marred by the fact that the la- 
bel for the branch was not 
similarly indented. 

Both programs providea use- 
fulset of utilities to the machine 
code programmer. Both pro- 
grams are very well written, 
although they suffer from be- 
ing written in Monitor mode 
(this affects DEA much more 
than DISA if you only have a 
tv). Of course it will be up to 
the budding machine code pro- 
grammer to decide which 
program is most appropriate, 
although I preferred DEA, 
mainly because it required a 
lot less knowledge of the pro- 
gram to be disassembled. 
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INFORMATION 

Program: Remind-me. A fast 
and compact date- 
reminder program. 

Supplier: Dilwyn Jones 

Computing 

41 Bro Emrys 

Tal-y-Bont 

Bangor 

Gwynedd 

£12.00. Mdv, 3.5 or 

5.25in disks. 

Works onan unexpanded OL. 


Price: 


hose of you who have 

met Joe Haftke will 

know that he has a 

thorough and me- 

ticulous approach to all the 

projects he gets involved with. 

In developing Remind-me, this 

admirable trait has continued 

and now we have for the OL 

one of those ‘Diary Manager' 

programs which are used ex- 

tensively throughout business 
and commerce. 


The date 


On BOOTing up you are 
quickly confronted by a screen 
which asks you to verify the 
present time/date. Inaddition, 
there is a display showing the 
amount of free memory avail- 
able. Having verified or cor- 
rected the present date, the 
screen changes to show you all 
the Events which should be of 
interest to you at that present 
time. In addition there is the 
facility to doa hard copy of the 
page. 

Not a great deal to that, you 
may say, but Remind-me has a 
few tricks up its sleeve. 

When the program was de- 
signed, it was decided that not 
only the current date should be 
shown, but also any entry oc- 
curring up to seven days prior, 
and all events and reminders 
right up to the end of the cur- 
rent month in which you are 
working. 

Therefore, ifthe program was 
run on 4th December 1991, it 
would show all entries from 
28th November until 31 De- 
cember. 
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Remind-me can hold up to 
54 different events scheduled 
by the user which should be 
enough for most domestic uses. 
Dates can be scheduled as'Each 
Year’ or 'Each Month’ as re- 
quired. 

The editing of Events is sim- 
plicity itself. The whole thing 
is menu driven and error 
trapped. Even if you try to en- 
ter an event on, say, the 13th 
month, then the program 
doesn't crash; you are just po- 
litely reminded by a comment 


on the schedule, such as "ER- 
ROR IN DATE". 


Joe suggests that the Remind- 
me is best used as a preamble 
program to your own most fre- 
quently used one, for example 
Taskmaster. When you have 
finished viewing your Diary, 
the EXIT option continues by 
BOOTing up the Taskmaster 
boot automatically once the 
disks have been swopped. 

All the usual Customising 
facilities are available, includ- 
ing default drive, printer port 
and Baud rate so all users 
should be catered for. In addi- 
tion, adummy diary of events 
is included so that you can 





ohn Shaw sets 
his computer 
alarm clock. 


practice on your backup copy. 
It also comes with a compre- 
hensive eight page manual 
which fully explains every- 
thing necessary to get the most 
out of the program. Newcom- 
ers to the OL are catered for 
and instructions on cloning are 
included. 


Miss no more 


Remind-me is a very profes- 
sional, useful and well- 
thought-out utility. Now there 
will be no more missed birth- 
days, insurance renewal dates 
or Quanta workshops. 
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Systematic 


Machine Code 


Programm 


In part 5, Alan 
Bridewell writes two 
8049 routines, for 
sound and 
keypresses. 





his series has been building a 
library of small chunks of assem- 
bler language code. Each chunk 
will do a recognisable job within a 
program, and be fully annotated, so that it 
will be clear exactly how to join it to other 
chunks of code to make a program, and 
what changes may be necessary to make 
the chunks fit together. 

In this part |am going to look at a couple 
of bits of programming that may, at first 
sight, appear to have little in common. 
These are making (and killing) sounds, 
and detecting key presses. The connec- 
tion between these is that the main micro- 
processor in the QL, the 68008, has noth- 
ing directly to do with them. They are dealt 
with by a separate microprocessor, the 
8049. In the QL, it is referred to as the 
independent peripheral chip (ipc). This 
means that it can get on with its work of 
controlling the keyboard, the sound gen- 
eration, and the microdrives, as well as 
other, undocumented things, without con- 
tinually referring back to the 68008. Every 
now and then it will respond if the 68008 
tells itto do something, but otherwise it will 
just get on with its jobs. 


It own rom 


Actually, the 8049 is more like a simple 
computer in a chip than simply a micro- 
processor, because it has its own rom of 
instructions and ram for data built into it. 
Unfortunately, we cannotaccess it directly, 
but have to tell the 68008 to do it for us. 
This is done by a trap 1 call which simply 
requires ##$11 in register DO, and in ad- 
dress register A3 it requires the start ad- 
dress of the commands for the 8049. That's 
where the real difficulties begin. 

For a start, the format of these com- 
mands must be exactly correct, or the 
system will probably crash, if not worse 
(more about this in a moment). The sec- 
ond complication is that the 68008 and the 
8049 can only communicate a nibble four 





44 


bits or half a byte at a time, and the 
command format reflects this fact. The 
actual command formatis as follows. (This 
next bit is complicated, and you may wish 
to skip it, unless you really want to un- 
derstand the details of the listings, rather 
than simply use them.) 


The first byte 


The first byte is the command to be sent 
to the 8049. (Actually, the command is in 
the lower nibble of the byte, which means, 
| assume, that commands are numbered 
$0 to $F.) 

The second byte contains the number of 
bytes of parameters being sent with the 
command. If this is not correct for the 


Listing 1 


WHICH ARE PRESSED. 


“Ws oe ed Oe ee 


BEST RESULT. 
» KEYROR MDVE .W 
NBP 
DEBRA 

; MOW THE KEYROW ROUTINE PROPER 
LEA.L 
MOVEQ 


TRAF #1 


#%FFFF DO 


KEYR, aS 
#$11,D0 








command, it will almost certainly crash the 
system. 

After these first two bytes comes a long 
word which describes how the parameters 
are to be interpreted. This is the most 
complicated part. Each pair of bits refers to 
a parameter byte (as there are sixteen 
pairs of bits in along word, that must mean 
a maximum of sixteen parameter bytes). If 
the pair is 00, it means send the lower 
nibble of the parameter byte. If it is 10, it 
means send both nibbles of the parameter 
byte. If itis either 01 or 11, send nothing of 
the byte. For example, the sound com- 
mand requires eight bytes, worth of pa- 
rameters, and the whole of all the bytes is 
to be sent. The bit pattern of the long word 
is 00000000000000001010101010101 


Bet He HEHE EEE EAE ED HEE FE BC EE RE EEE EE SHE EEE EE EE OTE BEE CEE 
*KEYROW ' 

FE FREE SEE FE ESE AE AE AE HE EE RE EC IE IE EASE HE HE BE BE EE EE IE EE EE THE BE IE BE BEE 

THIS COMMAND READS & KEYROW, AND REPLIES WITH THE KEY(S) IN THAT ROW 

IF CAN BE WED TD TEST FOR ANY NUMBER OF 

COMBINATIONS OF KEYE WITHIN THE SAME KEYROW. 

BUT IT WILL NEED TO BE REPEATED TO TEST FOR KEYS IN DIFFERENT KEYROWS. 


FIRST WE PUT IN A DELAY. THIS iS TO PREVENT EXCESSIVE USE OF THE IFC. 
THE AMDUNT OF DELAY SHOULD BE ADJUSTED BY TRIAL AND ERROR TO GIVE THE 


+ LOOP £4k TIMES 
3 DO NOTHING 


DO,KEYROW 14 


} KEYROW PARGM TABLE IN AS 
3 #IPCOs IN Do 


7 
IF FHE REPLY IS TO BE TESTED MORE THAN ONCE, MAKE A COPY 


MOVE .& D1, D2 


5_CGPY REPLY TO U2 


ALTER NEXT LINE FO TEST THE REQUIRED ROW {S: 
; BY USING DIFFERENT LOBICAL COMPARISONS AND OTHER BRANCH CONDITIONS 
A WIDE VARIETY OF KEY PERMUTATIONEG CAN BE TESTED FOR. 


CMPI.& 
BEG. 8 


#2, D2 


ROUT INE1 


; 18 COLUMN i PRESSED? 
1 IF 50, BRANCH 70 ROUTINE 


; ALTER NEXT LINE TO TEST THE REQUIRED ROWS) 


CMPI.B 
BEO.S 


#4,0i 


ROUTINE 


j 18 COLUMN 2 PRESSED? 
: IF &0O, BRANEH TO ROUTINE 


THE LAST FEW LINES CSN BE REPEATED AS MANY TIMES AS YOU NEED TO TEST 


DIFFERENT COMBINATIONE OF KEYE IN THE SAME KEVREW, 


THE ONLY THING YGU 


; MUST REMEMBER IS TO KEEP COPYING THE TRAP CAL? REPLY FROM D1 TO D2. 


BRA.S NOKEY 


7 ELSE BRANCH TO NOKEY 


; IF YOU WISH TO KEEP TESTING THE KEYBOARD UNTIL A KEY IN THIS ROW IS 


PRESSED, THEN 


"NOKEY' WILL BE ‘'KEYROW’. 


BUT If YOU WISH TG MDVE ON, IT 


WIL? BE THE NEXT BIT GF CODE AFTER THE PARAMETER TABLE. 


KEYROW PARAMETER TABLE 
. KEYR BE.B ig 
DE.B 1 


DC.B z 


= 
3 


; READ KEYROW 

7 ONE PARAMETER 

_ 7 LOWEST FOUR BITS ONLY 

i ALTER NEXT PARAMETER TO REPAITRED KEYROW 
DE.EB o 7 TEST ROW 6 

; REPLY OF @ BITS IN D1 


RHGH EEE EHEREHERESHEREREHRARAE AE ERRAERRAAATRRRAEAREREAKAESEERES REESE EERE S 
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010. This converts to the hex number 
SAAAA. 

Next comes the parameter bytes to be 
sent. Obviously, the number of bytes here 
must be the number indicated in the sec- 
ond byte of the command. 

Finally, we have a byte which tells the ipc 
the length of the reply expected. This byte 
must have a value of 1 for 'no reply ex- 
pected’, or 2 for ‘reply of eight bits ex- 
pected’. | don't know if others are accept- 
able, but these are the only ones | know to 
have been documented. 


Sixteen commands 


Although there can be up to sixteen com- 
mands, numbered $0 to $F, the documen- 
tation only deals with three: $9 to read the 
keyboard, $A to make a sound, and $B to 
kill a sound. In fact, the QL user is sternly 
warned not to try others for fear of most 
dire consequences! The chances of find- 
ing out what other commands might be 
used for is remote. In order not to crash the 
system, you need to put the correct number 
of parameter bytes in the correct format, 
and also guess whether a reply is ex- 
pected. This leaves a large number of 
random combinations to try before finding 
out anything useful. However, if the temp- 
tation to try a bit of probing in this direction 
is too great, | strongly recommend that you 
disconnect anything that might conceiv- 
ably be damaged before taking a leap into 
the dark. This would include making sure 
that no cartridges or floppies are in the 
drives, and disconnecting your hard disk 
drive if you have one. At one time, | did try 
a bit of probing but never succeeded in 
doing any more than crashing the system, 
or doing nothing that | could detect. By the 
way, If any readers do have information 
about these other commands, | would be 
interested in hearing from them. 


Our three 


The three commands that we can deal 
with are handled in listings one, two and 
three. The main part of all of them follow 
exactly the same format. First, the address 
of the command parameter table is loaded 


Listing 3 


Listing 2 


BEST RESIALT. 
. SOLIND 
» PAUSE 


vee UN oes eee 


MOVE ..W 
NOP 
DBRA 
LEAL 
MOYVEQ 
TRAP #1 
BRA.S 


; TABLE OF PARAMETERS FOR SOUND 


#$FFFF DO 4 


5 

DO,PAUBE 4 
SOUNCS,AS ; SOUNDS PARAM TABLE [IN 435 

#411 ,D6 i 

S 

3 


NEXTHIT 


MACHINE CODE 


Peel Se ee ee ee ee oe ee ee 
‘SOUND * 

$B FEF AEE AEE IEE He A HE HE HE EH A EEE HE EAE AE EEE SEE SEE EI ESE Sa a te aE 

THIS ROUTINE WILL PRODUCE A SOUND UBING THE Q@. SOUND GENERATOR. 

ADJUST THE PARAMETERS IN THE TABLE A5 REQUIRED. 

NOTE THAT ALTHOUGH THE PARAMETERS ARE ENTERED AS THOUBH THEY CONSIST BF 

B BYTES, THEY SRE ADTUALLY TWO BYTES, FOLLOWED BY TWO WORDS, FOLLOWED BY 

4 NIBBLES —- WHICH COMES TO THE SAME THING. 


FIRST WE PUT IM A DELAY. THIS 18 TO PREVENT EXCESSIVE USE OF THE IPC. 
THE AMGUNT OF GELAY SHOLLD SE ADJUSTED BY TRIAL AND ERROR TO SIVE THE 


LOOP 64K TIMES 
DO NOTHING 


#MT_IPCOM IN DO 
BKIf PARAMETER TABLE 


: THE FIRST THREE PARAMETERS MUST NOT BE CHANGED 


pC.8 Fh 
BC.3 8 


+ BOUNDS 


t INITIATE SOUND COMMAND 
} & PARAMETERS 
) ALL PO@RAMETERS ARE B BITS 


PC.L FAO 
t THESE CAN BE ADJUSTED TO THE REGUIRED SOUND 
o 


106 
#2000 
1000 
$i 
o 

¢ THIS MUST NOT BE CHANGED 

BC.B | 
k 


; PITEH 1 
PITCH 2 

; INTERVAL BETWEEN STEPS 
DURATION 
STEP NIBELE + WRAP NIBPLE 
RANDOM NIBELE + FUZZ NIBBLE 


) NO REPLY 


a HEHE TEE EEE HE EEE ERE RAPER EK EE EEE EE EERHEREHRERREGR EEE 





into address register A3. Next $11 is loaded 
into data register DO which tells the 68008 
that this is a command for the 8049. Then 
we make the TRAP 1 call. Ifthere is areply 
(which there Is if we are reading the key- 
board), we look for it in D1, and take 
appropriate action. If there is no reply (and 
there is none when making or killing 
sounds) we simply jump to the next bit of 
code. This much is easy. Most of the care 
needs to be taken in getting the parameter 
table right. 

Keyrow (listing one) concerns com- 
mand $9 which reads the keyboard. If you 
are familiar with the KEYROW command 
in SuperBasic, you should have no prob- 
lems with this one. You put in the keyrow 
of the key or keys you are interested in as 
a parameter, and the reply is the column 
value of any keys in that row that have 
been pressed. For the table of key rows 


FEES FE ESE EEE 2 TE TE IEE EE TE AE EE EE EER EE ELE LEE HERE R EER ERRAND ENE E EERE ER 
*KILLSOUND ° 
HERRERA RERREEE EERE AE ERAUAEE FARA REALEREERHARALELE ERE SERRE REE RARE KER HE 
s THES ROUTINE WIil. SWITCH OFF THE SOUND FROM THE SOUND GENERATOR. 


LEAL 
MOVES 
TRAP #% 
BRA.S 


KSOUND,AZ 5 
#$11,D0 


NEXTBIT 


KILLSOUND PARAM TABLE IN Az 
: #MT_IPCOM IN DO 


} 
; SKIP GVER PARAMETER TABLE 


i 
}KELLSOQUND PARAMETER FABLE — DO NOT ALTER ANY PARAMETER 


.« KSOUND DC.8 $B 
DC.B 0 
DC. B 0 


3 KILLSOUND 
; NO PARAMETERS 
3 NO REPLY 


3 
fH EERE EEE ERK EE HE 


Sinclair/QL World April 1992 





and columns, look under KEYROW in 
your QL User Guide. 

The listing starts with a delay loop. Con- 
tinually reading the keyboard with this 
command can cause problems when multi- 
tasking, because communication with the 
ipc is rather slow. It is also often unneces- 
sary, and the keyboard can easily be read 
several times during the course of one 
fraction of a second keypress, which is 
clearly a waste of processor time. By ad- 
justing the delay loop by trial and error you 
can ensure that the keyboard is not read 
more often than you can produce 
keypresses! 


Which way 


Next comes the trap call which is the 
same inall these listings, followed by some 
lines to look at the reply telling us which 
keys in the keyrow have been pressed, 
and taking appropriate action. Atthis point, 
there is a great variety of ways the chunk 
of code can go, many of which have iden- 
tical outcomes. (A full analysis of this would 
require a whole article on digital logic and 
Boolean algebra, followed by another on 
all the conditional branch instructions.) | 
have put in what seems to me to be the 
code most likely to be useful. What it does 
is to assume we will want to test more than 
one specific combination of key presses in 
the same row. (For example, in row 7 we 
might want to test for ALT-X, CTRL-X and 
CTRL-SHIFT-X, with each leading to dif- 
ferent results.) What it does not do is allow 
the testing for, say, any one of a group of 
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MACHINE CODE 


keys in the same row. (For example, we 
might want to see if any of the function lieting 4 
keys in row 0 has been pressed, without at 
this stage identifying which one.) This 


§ SHHHASHSHESESSEEE SEES E EEF FAH PEE HRSET ESSE SELS EES RESELL EEE EFELEC ERE BESS 


i ‘ JOBSTART * 
kind of thing can be done by careful use of ; 
ANDI.B commands instead of CMPI.B =e aoe AIDS Te eran tren ae 
commands, together with BNE.S instead Tia F4nFB : START OF A JOB) 
of BEQ:.S. 5; —~77= ALTER CHARACTER COUNT AND JOB AeeE —- 
Do. ¥# 13 ; CHARACTER COUNT OF JOB NAME 
I. “RURSORSCEIND” «6¢ «NAPE OF JOE 
H 4h 
More comparisons fo POR RA4S SS PASS SESSLER RTE ET i Ee FEE EEE BSS BSS ESS FOES ET 
1 “PRIORITY " 
| 
) “=~ ALTER LABEL TO .GTART —— 
Firstly, if more than one comparison is SEART pepe 445 1d ; #MT_PRIOR IN DO 

needed (that is, we're looking for more BOVED 4-1,D) > OF FHIS JO 
than one combination of key presses in ae Pfs De r Tu 8 
the same row), we copy the reply to regis- ‘ 
ter D2. This can obviously be left out if only | PROTO mS REE ESS SO BEES EE HIHHEEITHEHHHHEEE HH nt 
one comparison is needed, and must be ae 
repeated if we are making more than two . KEYROW HOVE.W 0 -W4SFFFF DO ' 
comparisons. Next we compare the copy a i magrem OS 
with the column value for the keys we are LEAL KEYR, AS , KE¥YROW PARAM FABLE IN 3 
looking for using the CMPI.B instruction. If neue valu 7 #IFCOM IN BO 


the comparison shows we have the com- 


‘ : : —---- NEXT 3 LIMES TO CoFY REPLY AND TEST NOT NEEDED, 30 DELETE --=~- 
bination of keys we were looking for, the 


—---- ALTER MWEXT CINE FO FEST REBRIIRED COLUMNS ———— 


BEQ.S command will branch to the appro- ) ——-- ALTER BRANCH ansncdd iis peas te Siete clues ee “ust hge Seg 
priate code. If not, the next two lines will Eo. 5 KEYROW2 |; TF BO, MOVE ON 

test the reply left in D1 for the other com- ) —--- &LTER BRANCH ADDRESS IN NEXT LINE TO KEYROW —-— 

bination we are looking for (assuming we Oo ee 

are only looking for two at the moment) 1 KEYROW PARAMETER TAGLE 

and branch to the appropriate code if the ee aera : yt ei 

comparison shows them equal. If none of 0C.L o LOWEST FOUR BITS ONLY 

the combinations we are looking for is ) —--- ALTER NEXT PARAMETER TO TEST ROW 7 ---- 

found, we then branch to appropriate code =e th ee oe 


with a BRA.S command. 
Finally, we have the parameter table, 
which will be as follows: 


HASSHESHS SEER ESTE DRESSES PEPE EELSSS HHH E HOSHRHH SS DSSS SRESEEDEA REDE 
“KEYROW" 


=—-~— ALTER LABEL IN MEXT LIME TO KEYROW2 ---- 
—rr- ALTER MEXT LINE TO GIVE A SHORTER DELAY ---~- 


byte $9 - read the keyrow KEYROWZ HOVE.M  §96000,D0 


byte $1 - one parameter byte ---- ALTER LABEL IN NEXT LINE TO PRUSEZ ---- 
i » PAUSE? Nor 
longword $0 - read lowest four bits only ; —---- ALTER BRANCH ADDRESS IN NEXT LINE TO PAUSE2 --— 
byte - parameter (number of DBR 4} , PAUSEZ 
Rp yrow. fe be lasted) had oT eres e EeaaL a MREYR2 CS Ms KEYROW PARAM FABLE IN aS 
. LEA.L KETRZ, 
byte $2 - reply of 8 bits expected in AED wiciesaaatO a. whINEEE Sh 5O 
D1 TRAP #3 t 
seyVE_ FF tH ba 3 COPY REPLY TO De 
‘ : y ---- ALTER NEXT LIME TO TEST REQUIRED COLUMN —--- 
Obviously, the only part of this that you CHP1L.B 44,02 1 IS COLUMN 2 PRESSED? 
will want to alter is the parameter byte, ) —---- ALTER BRANCH ADDRESS IA NEXT LINE TO AHISOUND ---- 
i j BER. 3 HISOUND 
which you adjust to the keyrow you re- , ---- AND NEXT 4 LINES TO TEBT OTHER COLUMNS —-—- 
quire. MEXJE 5 Di ,f2 
CeP].5 #126 ,D2 + 8S COLEMAN 7 FRESSED? 
BEQ.6 LOSHunMo t 
Sound loop MOVE.2 01,02 : 
CaP1_E #45,02 » SRE COLURS © AND & PRESSED? 
BED.6 KEYROW ry 
al é CrPi.B a9 Di 3; ARE COLURNS © AND 3 PRESSED? 
Sound (listing two) concerns $A which BER. & GULT ; 


makes a sound. As with Keyrow, this 
starts with a delay loop, and for much the 
same reason. There is no pointin trying to 


---- ALTER BRANCH ACEREBE IN NEXT LINE TO KEYROMWZ -—— 
BRA. 6 KE YROM2 5 


KEYROW FARAMETER TMHBLE 


—- ALTER LABEL IN WEXT LINE TO .KEYRE --— 
Start a new sound before the last one has " euwees Dc.B 9 | READ xevROw 
had a chance to get going! The param- DC.B 1 : ott 2 ate yc oped 
: : DC.L a i 
eters here are quite complicated, and , ALTER NEXT PARAMETER TO TEST KEYROW 1 
need some care. There are actually eight Dc. B 1 ; TEST ROW 1 
bytes worth of sound parameters, but they Du.8 z aREPey Eee te 
are divided into two bytes (pitch 1 and BESSSESSETZEEEEE S FERRER RAHHHERHEREREEREEE EERE EEE OHA 
pitch 2), followed by two words (step inter- ‘ “BOLING ° 
i i } 
val and duration), followed by four nibbles | ---- ALTER LABEL IN MEXT LINE fa LOSOLIND ---- 
(step, wrap, randomness and fuzziness). . LOSOUND HOVE.W 9 -#4F FFF, DO ; 
Assemblers cannot handle separate nib- a ee a 
bles of data, so step and wrap are com- c ==-- ALTER BRANCH ADRESS IN NEXT LENE TO PAES —-- 
bined into a byte of data, as are random- disci aed ition 


anne ABORESS TO LOSOUNIG —--- 
ness and fuzziness. So the complete pa- : ALTER LOAN ABORE 


rameter table will be as follows: 
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Lea. LOSOUNIG,AS ; SRUNDE PARAR TADLE IN AZ 
MOVEG Seli,00 +; #T_IPCON IN DO 
TRAP #1 
+ —— ALTER BRANCH ADDREBB IN NEXT LIME 10 KEYROW? ---- 
BRA.S KEYROWZ | SKIP PARAMETER TABLE 


F 

) TABLE OF PARAMETERS FOR SOLE 

: —--- ALTER LABEL IN NEXT LIME TO .LOBGUNMD -~-: 

.» LABOLWBE Do.B $F § INITIATE SGGNB COMMAND 


It. B B 5 & PARARETERS 
DC.L sh0008 1 SLL PARAMETERS ARR & BITE 
; ---- ALTER NEXT © PARANETERR TO GIVE REQUIRED SOUND ---- 
T.F 255 5 FITCH ¢ 
DC. & eae 5 FITCH 2 
GC. w a 5 INTERVAL BETWEEN STEPS 
Go. 4 a DURATION 
BC.B o 5 STEP NIBRLE + WAAP NIBBLE 
cr. & o 3 RANDOM MIBBLE + FUii MIBBLE 
a TRIS MUST OT BE CHANGED 
BC.B i ¢ MO REPLY 
: SESE HEARERS SEES STEERER ESSER ERES SER BSCE SELES SRE ERE REE 
5 ‘SOUND ' 
' 
} -—- ALTER L&BEL IN NEXT LINE TO HISQWUND ---- 
»HISOUNG MOVE, WW #3FFFF,20 j 
; —---- ALTER LABEL IN WEXT LINE TO .PAUBES ---- 
» PALER 4 NOF 
» —---- ALTER BRANCH ADDRESS IN NEXT LIME TO PAUSE4 ---— 
DBRA Oo, PAUBES 
) ---- ALTER LOAD ADDRESS (N NEXT LINE TO HISOUNDS ---- 
LEA.L HISOUNDS,AS ; SOUNDS PARAM TABLE IN AS 
MOVES #$11,D0 =; #MT_IPCOM IN DO 
TRAP #1 
} ===- ALTER BRANCH ADDRESS IN NEXT LIME TE KEYROW2Z —~—- 
BRA. 48 KEYROWZ 3; SKIP PARAMETER TASLE 


Lj 
t TABLE OF PARAMETERS FOR SOUND 
—-—- ALTER LABEL IN NEXT LINE TO .HISOUNDS —--—- 


. HISOUNDS bc.B $A ) INITIATE SOUND COMMAND 
DC.B q ; & PARAMETERS 
DG. I SARAA ; ALL PARAMETERS ARE 9 BITS 
$ ---- ALTER NEXT 6 PARAMETERS TO GIVE REQUIRED SOUND ---- 
BC.B i 9 PITCH 1 
pDC.B t 3; PITCH 2 
CC .W 0 ) INTERVAL BETWEEN STEPS 
DC.W t ; DURATION 
cc .8 9 t STErF NIBBLE + WRAP NIBBLE 
DC.B © ; R@NDOM NIBBLE + FUZZ NISBLE 
) THIS MUST NOT BE CHANGED 
bc.B 2 : NO REPLY 
3 
J HRHRAAHHHEREREHARATHHAAERAEAE REESE EE EAAHARERREAE HEAR EA HEHE EH RE RE 
5 *SDUND ‘ 
1 
3 —--- ALTER LABEL IN NEXT LINE TO QUIT ---— 
» QUIT MOVE. WwW #SFFFF ,DO | 
3} --— ALTER LABEL IN NEXT LINE TO .PAUBES -—--— 
«PAUSES NOP 
j =— ALTER BRANCH ADDRESS IN NEXT LINE TO PAUSES --~— 
DBRA BO, PAUSES 
LEA.L SQUNDB,A&3 3 SOUNDS PARAM TABLE IN Az 
MOVEQ #$11,D0 3 #MT_IPCOM IN DO 
TRAP #1 
5 ---- ALTER BRANCH ADDRESS IN NEXT LINE TO .END_JOB ---- 
BRA.S END JOB 1 SKIP PARAMETER TABLE 


5 
5; TABLE OF PARAMETERS FOR SOUND 


SOUNDS Bc.B $A ) INITIATE SOUND COMMAND 
DC.B B 3; 8 PARAMETERS 
Do.L SQLaB i ALL FARAMETERS ARE 8 BITS 
3 ---- ALTER NEXT & PARAMETERS TO GIVE REQUIRED SOUND —-- 
DC .B 50 ) PITCH 1 
Dc. B 190 : PITCH 2 
Do. ¥ $2090 7 INTERVAL BETWEEN STEPS 
Bo. i 1000 ; DURATIDN 
nc.B $11 ; STEP NIBBLE + WRAP NIBBLE 
Dc. B o ¢ RANDOM NIBBLE + FUZZ NIBBLE 
: THIS MUST NOT BSE CHANGED 
Dc. B 1 » NO REPLY 
I 
GRD ae De ae a he Ee eR ee ee 
; ‘ENDJOB" 
; 
.JG5_END MOVE. $CA,A2 3; UT_ERRO in AZ 
JSR iAz) 
: 
-END_JOB MOVEQ #5, DO ; #4T_FRIGB IN DO 
MOVEQ #-1,D4 3; IBD OF THIS JOB IN Di 
TRAP #4 j 


SRE RA BE BR BAER ERE REM ER ERE RMS ERE RES ERE RETR EREDAR EVV EDRE RED ED ERE ED 
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byte $A - make a sound command 
byte $8 - 8 parameter bytes 
longword $AAAA - Send all 8 bits of all 8 


bytes 

byte - pitch 1 

byte - pitch 2 

word - step interval 

word - duration 

byte - step nibble + wrap nibble 
byte -randomness nibble + 


fuzziness nibble 


Clearly the first three parameters must 
not be changed, but the rest you can adjust 
to the sound you require. This is not the 
place to go into the ins and outs of QL 
sound generation, but suffice to say it is 
somewhat peculiar. However, if you can 
produce the sound you want using Super- 
Basic, you should have no trouble convert- 
ing the parameters in listing two to the ones 
you require. 


No delay here 


Killsound (listing three) simply does that 
— kills any sound the QL may be making. 
There is no need for a delay loop here, 
because this code is unlikely to be re- 
peated in rapid succession except by mis- 
take! As the command carries no param- 
eters and no reply is expected, the param- 
eter table consists only of the following 
(and obviously needs no alteration): 


byte $B - command to kill a sound 
byte 0 - no parameters 
byte 0 - no reply 


Now to apply this new-found knowledge. 
Clearly the combination of detecting key 
presses and making sounds leads one to 
think of designing programs to make the 
QL behave like an electric organ. Although 
this is not particularly difficult, it must be 
pointed out that sound production is not 
one of the QL's strong points, and the 
results are likely to be disappointing. It is 
probably more fruitful to use the QL sounds 
to inform you about key presses. For in- 
stance, it would not be difficult to write a 
routine that made a little sound each time 
a key was pressed. 


Multitasking 


This could then multi-task with another 
program, say Quill, and it would reassure 
you that the keyboard was, in fact, still 
active, eventhough Quill was going through 
one of its 'l must sit back and think about 
this one' phases when you ask it to do 
something complicated with a large docu- 
ment. However, a word of warning about 
this. The ipc communication is rather slow, 
and continually scanning the whole key- 
board can slow things down considerably. 

A better option might be to simply scan 
certain important keys. For instance, if you 
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are like me, you may be staring at the 
screen trying to scroll down through a 
document, and finding it doesn't work, 
because you are at the top of the document 
pressing the UP key. Here is a routine to 
get over this. Quite simply, EXEC it before 
EXECing Quill or Abacus, and it will give a 
short high note when the UP key is pressed, 
and a short low note when the DOWN key 
is pressed. However, the program can do 
rather more than this. 

One other very useful application of the 
keyrow routine is that it enables you to 
produce the Hotkey effect. You can EXEC 
a program with a low priority, so it sits in the 
background doing nothing but checking for 
a particular combination of keys to be 
pressed. As soon as it detects this, it jumps 
into life, and starts doing its job. (Itcan even 
increase its priority to do it if necessary.) 
Then when it has finished what it was 
doing, it can go back to sleep (by lowering 
its priority again) and simply wait for same 
key press combination to occur again. We 
shall incorporate this into our program. 


Statements 


As before, rather than write a flow chart, 
| shall write a series of statements about 
the program, together with the names of 
the chunks of code, and any important 
points to be made. 


1. First, we start in the usual way with 
JOBSTART, with an appropriate job name. 

2. Because we want our program to 
multitask with word processors and 
spreadsheets without slowing them down 
too much, we use PRIORITY to set the 
priority to 1. 

3. Next we use KEYROW to test for a 
particular key combination to wake up the 
program. | have used CTRL-ALT-X, be- 
cause it is an obscure combination, un- 
likely to be needed in the other multi- 
tasking program, and also the three keys 
are in the same row so one KEYROW call 
will do. This will simply loop round if the 
keys are not pressed, and because it is a 
short loop, | have put the maximum delay 
time in it. 


Key combination 


4. Once our key combination has been 
detected, the main program is activated, 
and we move to a second KEYROW. This 
is altered to test for four specific key com- 
binations in row 1 and take appropriate 
action. Ifthe up arrowis pressed, it branches 
to give a short high sound. If the down 
arrow Is pressed it branches to produce a 
short low sound. If SPACE ENTER is 
pressed, it branches back to the first 
KEYROW, which effectively puts the pro- 
gram to sleep again. If ESC ENTER is 
pressed, it branches to a ‘quit’ routine. 
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5. Next we use SOUND three times, and 
adjust to give appropriate sounds. The first 
is the up arrow routine with a short high 
note, and the second is the down arrow 
routine with a short low note. Both these 
must finish by branching back to the sec- 
ond KEYROW ready for another key press. 
The third is the start of the 'quit' routine, so 
the program makes a distinctive sound 
when it has been told to kill itself. 


In at the kill! 


6. Finally we end with ENDJOB to kill the 
program. This is not strictly necessary, but 
it is bad form to have a program which 
cannot kill itself, unless it is to be called 
from another job which can kill it. 

So, putting all that together, we get: 

JOBSTART, PRIORITY, KEYROW, 
KEYROW, SOUND, SOUND, SOUND, 
ENDJOB. 





“It is bad form to have a 
program which cannot 
kill itself unless It is to 
be called from another 

Job which can kill it.” 





Listing four shows the result of merging 
the required chunks of code into a file and 
making the appropriate alterations to them 
to make them fit together. As before, most 
of the comments have been removed, with 
lines of asterisks left between the chunks 
to show clearly where one ends and the 
next begins. Also, additional comments 
have been added to point out the neces- 
sary alterations. You could, of course, 
simply copy listing four, and‘assemble it, 
but it would defeat the point of the exercise. 
Itis much more informative to start with the 
chunks of code, merge them together, and 
then make the alterations, and note why 
those alterations are made. 

Having got the program to work, you 
could then experiment with it. Try altering 
the sounds — you might find the ones you 
prefer. You could also test for other keys, 
and give them suitable sounds. If you area 
bit more adventurous, you could get the 
program to display a small window in an 
unwanted part of the screen (if you can find 
one!) to tell you the program is loaded, and 
whether or not it is active. 

In part 2 of this series, we put together a 


program to transfer bytes of data from one 
channel to another, for instance, to print a 
file, or to copy a file. This program is an 
excellent candidate for the Hotkey treat- 
ment, so it can be brought to life with the 
right key combination, and then put to 
sleep again when it has finished. The 
modifications needed are as follows. 


1. After Jobstart and Priority, the program 
goes into a loop looking for a particular key 
combination. (This should preferably be an 
obscure, non-printing one.) ALT-X would 
be good, because ALT and X are in the 
same row, which make it easier. 

2. On detecting the required key combi- 
nation, it jumps into the main routine. You 
could increase the priority if you wanted, 
but it is probably no advantage in this 
program. 

3. Oncompleting the file transfer, itcloses 
the channels as before. But now, instead of 
going to Endjob, it jumps back to the loop 
to detect the key press combination to start 
it up again. 

4. If this is all you did, it would never get 
to Endjob to kill itself, so Endjob could be 
deleted from the program. In this case, the 
program would remain active in the back- 
ground until you killed it with a toolkit 
command, or reset the machine. This is 
rather crude programming, as all multi- 
tasking programs should be removable 
from within the program when it is finished 
with. There are a couple of reasonable 
ways to do this in this case. One is to print 
amessage asking if the program should be 
aborted when the file transfer is completed, 
and instructing the user to press ALT-Y to 
kill the program or ALT-N to just put it to 
sleep. It could then detect the appropriate 
key presses for either a jump to Endjob, or 
a jump back to the start. The other way is 
to use the loop atthe start to check for a key 
combination (ALT-ESC, for example) to 
jump to Endjob as well as check for ALT-X 
to jump into action. Both alternatives have 
good and bad points, and it is really a 
matter of taste. 


Two more things 


Two other things you could do to the 
transfer program to make use of the sound 
generating potential. You could (a) get the 
program to make a suitable rude noise 
instead of an error message if Open cannot 
open the channel, and (b) get the program 
to make a more pleasant sound on comple- 
tion of the file transfer. 

So there it is. Although we have only 
increased our little 'Assembler Toolkit’ by 
three routines, and only used two of them 
in our examples, | hope you can see that 
they are very useful ones. With good use, 
they can improve the user friendliness of 
your program by quantum leaps. (Haven't 
| heard that somewhere before, many years 
ago...) 

Happy coding! 


Sinclair/QL World April 1992 


t TF Services [Ff 


MINERVA QL SPARES 


The ULTINATE operating systen upgrade Faulty GL boards (excl plug in ICs) 


Keyboard membrane... &8 Circuit diags,.. £2 

HKIT MINERVA now with battery for 256 bytes 68008 CU sssesseeees £8 1377 PALssseeses £3 

rom, CRASHPROOF clock & interface (I®C) for JM rom Set.ssseeeee E12 Power supply... £12 

robots etc. Can autoboot from battery ram. 8302 ULA..sssseeeee £10 9301 ULA....... C10 
Other features (common to MKI/MKII): 


BO49 seevesesveeeees £8 MOV ULA wessees E12 
Autoboot on reset/ Multiple Basic’ Fuster Other components (sockets etc)... plse PHONE 
scheduler-graphics (18% of Lightning)-string 


Seeeermemirea BULLETIN BOARD 


Foreign kybd drivers?’ ‘Warm’ fast reset etc 

MKI to MKI UPGRADES: up to 1,79-£5. Rest FREE 

(send rom (PROTECT LEGS!) and disk or 2 mdys) (BBS - uk's first OL scrolling board 
QL Echomail around Europe, and FIDO netmei| 


ns en inst ie OTR Around 1@nb of files including the WHOLE 
ALL VERSTONS FULLY GOLD CARD COMPATIBLE King James’ bible! 


. DiL=706 2379 U2ke2de22ee2bis ethes 
QuaLsof t Terminal 
Viendata/VT52/UT100 OL TERMINAL EMULATOR al REP A | RS 


Multitasking for electronic mail, PRESTEL etc, 
CET download. Compatible with Tandata Gconnect i 
AL noden/nodaptor,. Use Gconnect RE232C to drive) | “rs ested with Thorn EMI test rig 
unbuffered modems. Comprehensive AS manual. (HOV hardvare extra if required) 
E27 —- & month guarantee 


COMPUTER CLEANERS FILE TRANSFER 


HELP STOP POWER SUPPLY INDUCED LOCKUPS 
AND PROTECT COMPUTERS 
free (XNODEM between computers 
Much improved mains filters. 48-88 db cut, ees Sigs 
Contain inductance, spike filters (three in 
3 & 4 way) and certified 248vac capacitors. 


Available for IBM PC and compatibles, 
ATARI ST and Sinclair QL. Connects to 
Psion organiser via Psion comms link 
2-woy (Sa adaptor) sesseres 

S-way (Sa adaptor) 

4-woy (13a trailing socket) ...ssse.005 


QuaLsoft program (per m/c)..... £7.50 
Serial lead (name 2 computers)... £10 
Complete package for 2 computers. £25 


All prices include VAT and postage in the UK MAIL ORDER ONLY 


12 Bouverte Place, London V2 1RB (tel: A71-724 9853) 


SCROLLING BBS FOR ORDERING/QL HELP - 871-786 2379 (AL\ speeds to V22bis) 
Fox: 871-786 2379 Prestel: 617249853 





Independent OL/Thor Users Group 


Worldwide Membership is by subscription 
only, and offers the following benefits: 
Monthly Newsletter - up to 40 pages 

Massive Software Library —- mostly FREE! 
Free Helpline and Workshops 

Regional Sub-Groups. One near you? 

Advice on Software & Hardware problems 
Discounts from most major suppliers 
Subscription just £14 for UK members 

Overseas subscription £17 


Barclaycard: Visa: Access: Mastercard 
* Now in our EIGHTH successful year * 
Further details from the Membership Secretary 


Bill Newell 
213 Manor Road 
Benfleet 
Essex. SS7 4JD 
Tel (0268) 754 407 



























QPAC Il by Tony Tebby 


MAKES YOUR QL TRULY MULTI - 
TASKING 


QPAC || Main menu windows adjust automatically 
to size. Files, directory, view, print, delete, backup, 
jobs, pick, Rjob, sort, channels, things exec, wake, 
buttons, Hotkey, Hotjobs. Fully multitasking, allows 
many programs torun at once. Requires min of 256k 
OXPAMAGG: MEMO Ye si.s.cc.cc.s5scvacacoussceetsccsseovseceecssde 


soli SPECIAL OFFER ONLY £39.48b 
Upgrade QRAM to QPAC II return master . 
ROOT oo) EOE» Se ee eae @29.61b 


PLEASE SEND SAE FOR A COPY 
OF THE QPAC Il REVIEW 


QPOWER REGULATOR 


Switch mode power supply, QL runs cool, 
Stops lock ups (due to voltage drop). Helps 
filter noise out. Simple to fit (no soldering) . 
sesokbcuesuluanadepuutedcnagcousucaccavecneeanbaee® £25.85c 


QL SUPERTOOL KIT Il by Tony Tebby 


Over 118 Commands: Full Screen Editor, Key 
Define Print Using, Last Line Recall, Altkey, 
Job Control, File Handling, Default Directories, 
Extended Network. 

16k Eprom Cartridge Version....... @£23.50d 
Configurable Version of Microdrive .............. 








ZITASOFT SOFTWARE by Steve Jones 
LOCKSMITHE copies M/DRIVE - M/DRIVE 


6 RIS SOS oe co ee @£14.10c 
4MATTER+LOCKSMITHE copies M/DRIVE 
LSS, Sa ener ae ee @£23.50c 


SIDEWINDER - High resolution printer driver 
prints full screens or parts of screens from 
postage stamp size to large banners. Prints 
sideways, invert, scale, mirror, text insertion 
FSCS eS @£20.21¢ 
SIDEWINDER PLUS - (for expanded QL's) 
includes all the features of above, PLUS 
multiple label printing, desktop publishing 
files and printer drivers for The LC10 JX80 24 
pin and colour printers (Please state 3.5" disc 
OPM DEVO) 5. d8e......0ct Rticreeverers- @£23.97c 
Upgrade to Sidewinder Plus ........ @£8.46c 


HOW TO ORDER 


bE Public Domain and 


C68 Public Domain 'C' Compiler 


Consists of 8 3.5in Disk's, containing the following: 
iski:Nain System Disk- fie 4-8:Source 1 to 5- 
ontains the various ontains Source Code for 
passes of the Compiler, C66 Compiler, CC, CPP, 
isk2:Utilities-Contains 9566, LD, Generic part 


all Utilities associated of Standard ‘C* Library, 
QDOS Specific part of 


vith C68. CS Lib fidditi 

Disk2:Documentation- Alt me serene 

TnGettt "rdoe' formats, Librarles ok ULUities 
a4 Fee 

£3.08p-User Suppiles Disks £6.88p-Pre-Copled Disks 





C Tutorial & 





(68 'C' Tutorial 


This Tutorial vas or 
running - 'C’ is 
opplies virtually 
PLES TOP ee et emanation fen bean pute 

es Vieulng ond printing from Quill. 
: Scattered through he text are a number of coments all headed 
068". These are comments uhich have bean added ond are hosed 
on having worked through the Tutorial to learn 'C’ and to clarify 
some differences betueen QL/068 and IBH/H9008 env 

£8,58p-User Supplies Dick £1.@8p-Pre-Copied Dick 


2nd User HéVore & 3/Ware 


2nd User Harduare and Softvare is available 
from time to time. Please ring for details of the 
current stock being held. Items available include 
as follous:- 


iginatty witten for PC's or Compatibles 
designed to be a portable language so it 
to the C68 for OD0S implementation. 
to a set of _doc 


QL's (Full & Backup), Disk I/Faca's, Nemory Expan- 
sion, Disk Drive's, Printer's, Monitor's (Colour & 
Green Screen), @L Related Books, QL User/Vorid 
Back Issues, QUAHTA Back Issues, Blank Disk's and 
all sorts of Commercial Softuare including Cames 
and Utilities, 


CARE ELECTRONICS 








By Post. Enclose your Cheque/PO made payable to CARE 
Electronics or use ACCESS/VISA. Allow 7 days for delivery 


For The 
. Sinclair @.L. 


S.A.E. (AS) for Softuare Catalogue 


Compact’ form. 
ronments. Copying Fee Mere (s a program on the Disk unich ullt Un-Compact the files. 














































SOFTWARE 87 (State MDV or Disc) 


TEXTS? Blus By. sccateenc.ae,-...0e @ £79.00b 
POUNTED 80 sscscccccscthae.ctteacep Ble @ £15.00 
FOUNTED 88  ..5.00s<s2ctescccstetsseuents @ £25.00c 
248B PRINTER DRIVER ............ @ £15.00c 
Upgrade to Text 87 Plus 4 from V3.00. Return 
PEI 5288s. 5 aks ens scicdteosvssazensocccteneiss £39.00b 
Upgrade to Text 87 Plus 4 from all other ver- 
sions. Return Master ..................0.. £49.00b 


Send SAE for further info on above. 
MIRACLE SYSTEMS PRODUCTS 





OK Disc Interface (inc Tool Kit II) ....... @ £99.64b 
QL Centronics Printer interface ......... @ £29.61d 


QL HARDWARE 
QLKeyboard Membrane ............. @ £11.75d 
Care Eprom Cartridges each ........ @ £6.11c 
UEA CHIDO ZXBS0 1225.0: sctcecesctes @ £15.98c 
READY MADE LEADS 
RAGRQETO PHONG........0:5...0.cetereooss £6.11¢ 
FIGS 8-6 BIN 2s svescbttossossbiesesooanebo sa: £7.52c 


TONY TEBBY SOFTWARE (QJUMP) 


QTYP Type/Spell Checker ......... @ £30.55d 
QPAC 1-Desk top accessories, calendar, 
alarm, calculator, typewriter, digital clock 
SVSMOMN Bt sskeeesscsscceetecscontessacsem a £22.56d 


CARE ELECTRONICS 
DEPT QL, 15 HOLLAND GDNS 
GARSTON, WATFORD, 
HERTS, WD2 6JN. 

Tel: 0923-894064 
Fax: 0923-672102 


Please add carriage 
a=£6.11 b=£3.76 c=nocharge d=£2.35 






Shareware Softuare 






















NicroEMACS V3.9p Text Editor 


Consists of 2 3.5in Disk's, containing the follovings 


i iNain Proram Disk- Disk2:Source Code = 
ontains EMACS Hain prog Contains all relevant 
CS_RC Resource file, Source Code for Nicro- 
EMACS_HLP Help file, ENMACS U3.9p. 
ENACS_NSS User guide, 
EMNACS_TUT Tutorial. Aliso includes document 
on the latest update, 
ENACS1_doc to ENACSF_doc and hoy (t has been re- 
User guide in _doc fora. compiled using (C68. 








ing Fee 


Copy 
£1.88p-User Supplies Disks £2.86p-Pre-Copied Disks 








la IGA) 
OL Emulator 3.18 (ANIGA) 


The Emulator \s suppiled on 2 Disks as follous:- 
Disk i: This Disk is in AMICA format and coninins the Eaulator in 


512K, 1Mb, 2b and 4 form. There is also extensive documentation 
in English onty, 


Disk 2: This Dick is in QL format and contains all the Source Code 
plus some Utilities. Majority of the filles are in ' 







£2.88p Pre-Copied Disk's only 


Public Domain Authors 


QUEBESoft P/D are alyays seaking Authors of any 
type of Public Domaln Softuare for the @.L. If you 
have uritten a program for the Q@.L. then vhy not 
send it in for evaluation. 


Poyment 


Cheques/Postal Orders payable to :- 'K.Dunnett' 


Postage & Packing 
C68-SOp (UK) £1 .S@8 (EUROPE) £2.50 (REST OF UVORLO) 
ENACS .C Tutor 4 Emu -38p (UK) 78p EUROPE) £1.58<REST WORLD) 























38, Brunuin Road, Raune, Braintree. Essex. Cti7 SBU. Tel No. (8376) 47852 
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For Sale, QL Minerva 512K Ramplus HARD DISK BACKUP AND FILE 
Qdisc 3 interface Toolkit2, Rom battery MANAGER with subdirectories, listings, 
backed clock, Tandata Modem Set etc. Needs toolkit. £20 on 31/2" disk, £15 
collection software and books, Quanta members. C. Turner, 43 
assembler, QLWorld 1984-1992,some Hamesmoor Rd., Mytchett, Camberley, 
spares, £200. Phone Chris 0992442807, Surrey. 0252 541968. 


QL SYSTEM COMPRISING: QL, Prism Cc: 
colour monitor, BrotherM1009printer,256K §\/P ' Ce FAC) AALS 
Trump Card, two 5'/," uncased disc drives N/E 1 Co 
with power supply, Modem, Software and IN/T I C> 
extras. £175.00. Tel: 0226 293729 IN/T IC 

IN/I 1 Co 


evenings. 































QL REAL TIME DIGITIZER 
Digitize moving pictures in real time. Transforms QL into a 
video printer or 3-D image digitizer via a video camera/recorder 
* Digitizes in .02 secs. 


QL ROMS AND SPARES 


ROMS, MGE (Spanish, MGF Ae MGG 
(German), JS (English), £20 each. (English), 


MDVS. Complete QL MDV Subunit £20, head 
and chassis £10, Microswitch £2, Motor £6. 
Rubber & Plastic Roller £2. MDV2 Stand-off 
spacer + srew £2. ULA £5. Tr 4,5,6,7 set £2. 
MDV pcb inc, ULA £11. Prices include UK 
postage. Send SAE for price list of all QL spares. 


Joe Atkinson, 36 Ranelagh Road, Ealing, 
London W5 SRJ (Mail Order Only). LONDON NW2 5NG TEL: 081 459 1351 


er / Oo colio ELECTRONIC 


QTop The definitive User-Front-End V1.11 SFR 70.-- 

The QL's equivalent to WINDOWS on MS-DOS PC's, The system-manager offers the mainmenus DESK, 
DEVICES, FILES, JOBS, KEYBOARD, PROGRAMS, MY PROGS, TOOLS and OPTIONS with 
over 110 sub-menus. QTop is ideal for Gold-Card or Harddisc users as it supports real Sub-Directories. The 
powerful QJUMP extended Pointer Environment is included and all its facilities are supported, Comprehen- 
sive 41 page manual. 

ArcED The professional Text-Editor V2.6 SFR 39.-- 

The Text-Editor especially for programmers. Written in fast, reentrant machine code (only 20KB). 
Comprehensive 29 page manual. 

ExeQtor The Super-QL in a limited edition/ask for quotation. 

We use the QL PCB, GOLDCARD, QIMI & Mouse, JFC K90 & MF-2 Keyboard, up to 3 discdrives and a 
harddisc (option) to build the Super-QL in a Tower case. QTop and ArcED are included on the system disc. 
Ask for free product information. Software is available on 3.5" or 5.25" disc. All our products are compatible 
with all QL compatible computer. Free updates and user-support. Please specify English or German version. 
Prices including P&P. Send orders with cheques to drawn in SFR to: 


COWO Electronic 


Urs Konig, Miinsterstrasse 4, CH-6210 Sursee, Tel 045-211478 
or contact TK Computerware (UK) and QLympic Computer Systems (Germany) 


* 256x256 resolution in 8 levels 

* Full, '/4 or 4x '/, screen modes 

* Screen update - 5 or 2.7 frame/sec 

* 4:1 grey level 9-pin printer dump. 

* Interfaces to QL ROM PORT 

* Runs on unexpanded QL and multitasks. 

* P&P 3.00 UK, 9.00 overseas, state MDV or FLP 

CL SYSTEMS, 403 CHAPTER ROAD, DOLLIS HILL 








» “WHO PUTS IT RIGHT? 


IS er 


We do. The Advertising Standards Authority ensures 
advertisements meet with the strict Code of Advertising 
Practice. 

So if you question an advertiser, they have to 
answer to us. 

To find out more about the ASA, please write to 
Advertising Standards Authority, Dept. X, Brook House, 

Torrington Place, London WC1E 7HN. 


This space is donated in the interests of high standards in advertisements. 
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NEW THIS MONTH 


DSHD DISKS 
CRICKET SECRETARY 
TEXT 'n' GRAPHIX 


(see FLOPPY DISKS) 
(see LEISURE) 
(see TEXT) 


CATALOGUE 
PLEASE ASK FOR A COPY OF OUR QL SOFTWARE 
CATALOGUE. WE NOW SELL SO MANY ITEMS 
THAT WE CANNOT PROVIDE MUCH DETAIL IN 
THE ADVERT, THE CATALOGUE CONTAINS MORE 
DETAILS OF THE PROGRAMS AND A SAMPLE 
SCREEN PRINTOUT FROM MOST OF THEM 


SOFTWARE DISCOUNTS 


BUY 2 PROGRAMS TOGETHER 
CLAIM 5% OFF 


BUY 3 OR MORE PROGRAMS 
CLAIM 10% OFF 


LABELS 


MICRODRIVE LABELS roll of 100 

DISK LABELS roll of 100 

100 DISK LABELS on printer roll 
100 ADDRESS LABELS on printer roll £2.00 
Please add £0.50 postage per roll of labels (max 
postage £2.50) if only ordering labels. 


FLOPPY DISKS 


3.5"DSDD UNBRANDED DISKS 

20 OR MORE UNBRANDED DISKS 
3.5" DSDD SONY BRANDED PACK OF 10..£9.00 
3.5" DSHD HIGH DENSITY DISKS 
5.25" DSDD UNBRANDED DISKS 
MICRODRIVE CARTRIDGES - please phone to ask 
about price and availability before ordering. 
POSTAGE RATES - SEE BELOW. NO NEED TO ADD 
POSTAGE ON MICRODRIVE CARTRIDGES 








DISK STORAGE BOXES 


POSSO BOXES, drawer style, holds 150 or more 
3.5' disks. Stackable disk storage system, in black, 
Scie AG 5 no nintsneeaeenersas einen £17.00 
Plastic case, holds 80 3.5" disks ...........00 £7.00 
Plastic case, holds 40 3.5" disks ..........0.. £5.00 
(both above boxes have clear, lockable lids and a 
small set of disk dividers) 

Small case for 10 3.5" diSkS wee £1.20 
POSTAGE RATES - SEE BELOW 











STANDS 


MONITOR STAND, TILT/SWIVELACTIONS, HOLDS MONITORS 
WITH UP TO 14° SCREENS 


PRINTER STAND, 80 COLUMN PRINTERS 
POSTAGE RATES - SEE BELOW 








Dilwyn Jones Computing 
41 Bro Emrys, Tal-y-Bont, 


Bangor, Gwynedd LL57 3YT U.K. 
Tel: Bangor (0248) 354023 


QL SOFTWARE 


NB MEANING OF CODES IN SQUARE BRACKETS BELOW 
[R] RAMDISK REQUIRED 
(F] AVAILABLE ON FLOPPY DISK 
[1M/2M] AVAILABLE ON MICRODRIVE & NUMBER 

OF CARTRIDGES REQUIRED 
[128/51 2K] MINIMUM MEMORY REQUIRED 
PRICES OF SOFTWARE AVAILABLE ON MICRODAVIE 
HAVE NOW BEEN SIMPLIFIED. PLEASE ADD £2.00 TO 
THE PRICE SHOWN BELOW TO COVER THE EXTRA 
COST OF THE MICRODRIVE CARTRIDGE(S) AND 
DUPLICATION, OR ENCLOSE YOUR OWN 
CARTRIDGE(S) WITH THE ORDER AND PAY THE 
PRICE SHOWN. 


FILE TRANSFER 


DISCOVER 

[F 256K] Copy files from QDOS to PC disks and 
vice versa. No cables required! 
MULTI-DISCOVER 

[F 256K] Enhanced version, also featuring trans- 
fer between QDOS and BBC micro DFS/ADFS, 
CPM and UNIX CP10 disk formats. 

TEXTIDY 

[F 256K] Strip out control codes from Quill text 
files etc and assist Discover with text file conver- 
sion to other computers. 


LEISURE 
CRICKET SECRETARY 


[F 2M 128K] NEW! Record, display and print 
CRICKET AVERAGES, etc - all the traditional features 
of batting and bowling averages, "how out" analysis, 
best bowling, runs per over and bowls per wicket. 
Useful for cricket club secretaries and fun for all 
cricket buffs who'd like to keep a record of how their 
heroes have fared! 


QUESTION MASTER 

[F 2M 128K] Question and multiple choice answers a 
program - use for revision or just for entertainment. 
QUESTION SET 1: GENERAL KNOWLEDGE .. £5.00 
QUESTION SET 2: CLASSICAL MUSIC 

QUESTION SET 3: QL-ESTIONS 
(ALL 3 SETS WORK IN 128K OR MORE MEMORY 
WITH QUESTION MASTER PROGRAM) 


FLEET TACTICAL COMMAND II £49.95 
[F 512K] Naval strategy game, playable on one or two 
networked computers. Ask about the information 
booklet for this superb game. 


FTC DATA PRINT UTILITY 
[F 512K] Add-on for FTC || described above. 


THE FUGITIVE 
[F 512K] Text adventure game. 


COCKTAILS WAITER 

[F 256K] Database of hundreds of recipes for alco- 
holic drinks. Useful for hotels and bars, or just for 
entertainment at home. 

View, search, select, print, etc. recipes. 

MIX 2 RECIPES FOR C.W. ....................0008. £5.00 
MIX 3 RECIPES FOR C.W. ...............ccccceee £5.00 
(BOTH WORK IN 256K OR MORE MEMORY WITH 
THE COCKTAILS WAITER PROGRAM, 100'S OF 
RECIPES) 























PROGRAMMING 


Cg | £10.00 
[F 1M 128K] List variable names, keywords, proce- 
dures, etc. Useful for BASIC programmers. 


BUDGET QLIBERATOR COMPILER ......... £25.00 
[F 1M 128K] Version of the QLiberator SuperBASIC 
compiler for unexpanded QL's. 


QLIBERATOR BASIC COMPILER ............. £50.00 
[F 256K] A full QL SuperBASIC compiler with even 
more features than budget version! 


QLOAD & QREF UTILITIES............0.0.... £15.00 
[F 1M 128K] QLOAD is a fast load utility for BASIC 
programs. QREF is a cross referencer for listing 
names used in BASIC programs. 





FILE HANDLING 


PES 2 sscessscassacvssevscsazecessnseenansceosssaasiaasen £12.00 
[F 1M 128K] Simple to use popup file handling utility 
for viewing, copying, deleting, renaming etc files. 


PE EG casciccusssciccexcgnccoastunnsesniee £12.00 

[F 1M R 512K] For bulk copying, deleting, etc of files 
quickly via ramdisk, also does simple disk labelling 
& files list printout. 


THE GOP BER scsccccicncsnsceneenc 

[F 1M 128K] Searches for and tells you which files 
contain a given text string, e.g. ask it to find letters 
referring to Mr Jones 


WINBAGK sssssitssiticcccacannccsnsanden £25.00 

[F 256K] Hard disk backup program for Miracle hard 
disk and compatibles. Version 2 due soon - ask for 
upgrade details. 





DISPLAY SOFTWARE 


VISION MIXER 1 

[F 2M 384K[ Screen display software, use for any 
eye-catching display of QL mode 4 or mode 8 
screens, e.g. for advertising. 


VISION MIXER PLUS 

[F 384K] Enhanced version, but even easier to use. 
Now menu driven, with new effects and greater 
Capabilities. 


PICTUREMASTER 

[F 256K] Screen maker for use with Vision Mixers, 
or can also be used as a Simple to operate graphics 
program. 


PICTUREMASTER PLUS 
[F 384K] Enhanced version, with additional fea- 
tures. 


UPGRADE TO PICTUREMASTER PLUS ..... £5.00 














GRAPHICS 


THE PAINTER V4.04 ; 

[F 512K] 100% machine code art and graphics pro- 
gram, by PROGS of Belgium. Multiple screens, can be 
mouse controlled, selection of fonts, patterns, many 
facilities. 


THE CLIPART : 
[F 128K] 3 disks full of clipart pictures, for use with 
most DTP/graphics programs. 


QRACTAL 
[F 512K] Machine code fractals program. Displays 
Julia or Mandelbrot sets. 


QRACTAL SCREENS 
[F 128K] A disk full of sample screen pictures gener- 
ated with the QRactal program. Buy this to see the 


sample pictures, then ask about a discount when 
buying QRactal itself! 


IMAGE PROCESSOR V2 . 

[F 256K] Image enhancement, edge detection, zoom 
and edit, touch up picture generated by digitisers, 
scanners or other graphics programs. Works with 
mode 4 or 8 screens. 


UPGRADE OLD IMAGE PROCESSOR £10.00 
(Send proof of purchase of old version) 


PD2 CLIPART : 

[F 128K] Clipart made for PD2 Plus, but available in 
screen format for use with other DTP/graphics pro- 
grams if required. 


SCREEN SNATCHER 
[F IM 128K] ‘Grab’ screen displays from within other 
programs that are not able to save their own displays. 


TEXT ‘N’ GRAPHIX 

[F 256K] NEW! Allows you to insert screens, or part 
of QL screen pictures, into a Quill or plain text file 
printout. Mix NLQ text and graphics in the same 
printout! Currently only for use with 9 pin Epson 
compatible dot matrix printers - ask about a version 
for 24 pin printers due soon. 


TRANS24 : 
[F IM 128K] Translates 9 pin graphics printouts into 
data for.a 24 pin printer. 





DTP 


PAGE DESIGNER 2 PLUS 

[F 512K] QL Desktop Publishing program, mix text 
and graphics, make printed pages or posters, use 
Clipart, use graphics from other programs etc. 
Prints on most printers. Ask for details! 


UPGRADE PD2 TO PD2 PLUS 
(Send proof of purchase of old PD2) 


VISA 









Dilwyn Jones Computing 
41 Bro Emrys, Tal-y-Bont, 


Bangor, Gwynedd LL57 3YT U.K. 
Tel: Bangor (0248) 354023 





DATA BASES 


ADDRESS BOOK & LABEL PRINTER £15.00 
[F 2M R 384K] Store names and addresses and 
print them out on a variety of label sizes, or print a 
telephone list, etc. 


DATA DESIGN 

[F 512K] Superb, fast 100% machine code 
database by PROGS of Belgium. Programmable via 
BASIC and machine code interfaces - write your 
own database applications in BASIC using the 
DATA Design commands to help you! Runs in 
pointer environment (supplied) 


FLASHBACK 
[F 1M 256K] Fast machine code database which i is 
also very easy to use. 


FLASHBACK SPECIAL EDITION £40.00 
[F 2M 512K] Enhanced version of Flashback, new 
commands, report generator, etc 


UPGRADE TO FLASHBACK §.E................... £20.00 
(return Flashback master disk) 


QL GENEALOGIST, STANDARD VERSION .. £19.50 
[F 2M 384K] Family trees and family history 
database, one of our best selling programs. 


QL GENEALOGIST SECOND EDITION £30.00 
[F 384K] Enhanced version - for details see our 
advert in QL World December 1991. 


UPGRADE TO SECOND EDITION £12.00 
(return Genealogist master disk) 


BUDGET 128K QL GENEALOGIST £12.00 
[F IM 128K] Cut down version for unexpanded 
machines. 


SUPER DISK INDEXER ; 
[F IM 384K] Catalogue your disk collection as a 
database of files. Store it, print it, search & find 
files, make your life easier. 


QL HARDWARE 


MINI PROCESS CONTROLLER : 
Relay switched outputs, controlled via QQL serial 
port. 


SOFTWARE TOOLKIT FOR MPC ABOVE £9.95 
[F 128K] Control the MPC from BASIC programs 
more easily with these extensions. 


NETWORK PROVER 
Plugs between network lead and computer to give 
a visual indication of transmission. 


POSTAGE RATES - SEE BELOW 


TEXT 


BIBLE TEXT DISKS, EDITOR FORMAT 

BIBLE TEXT DISKS, “DOC” 

[F 256K] Text of the King James Bible on disk. 
Please state whether you require Editor (plain text) 
or Quill “_doc” format 


SPELLBOUND ; 
[F IM 384K] A spelling checker which can check 
Spelling as you type! 30,000 word dictionary. 


SPELLBOUND SPECIAL EDITION £50.00 
[F 512K] Enhanced version of Spellbound with 
50,000 word dictionary & many new features. 
UPGRADE TO SPELLBOUND S.E................ £30.00 


QUICK POSTERS 
[F 2M 128K] Text poster maker, for use with Star 
NL, XB and LC printers 


ROB ROY BARGAIN PACK 
[F 3M 128K] Reviewed in QL World August 1991 


HOME BUDGET 
[F IM 128K] Domestic bills and accounts program, 
plus a UK Income Tax Calculator. 


REMIND-ME 

[F IM 128K] Dates and events reminder program - 
remember about birthdays, licence renewals, etc. 
Quick and very easy to use. 


SCREEN ECONOMISER 
[F IM 128K] Turns off the QL display after a set 
number of minutes to protect the screen. 


SLOWGOLD ! 
[F 128K] Slowdown routine and control panel for 
software which runs too fast on Gold Card or 
indeed any QL system. 


TASKMASTER 

[F IM 384K] Task switching utility. Enables you to 
conveniently switch between several programs in 
memory. Calculator, notepad and file handling 
utility included. 


SUPER DISK LABELLER 

[F 256K] Print neat labels for your floppy disks 
listing the filenames on the disk in columns in 
small print. 


THE CAT 

[F IM 128K] List files on a disk or cartridge to the 
screen, or print on paper, in columns (optionally 
sorted in this latest version). Useful and convenient 
utility. 





%* SEE ALSO THE OTHER HALF OF THIS ADVERT ON THE PRECEDING PAGE * 


for airmail postage where possible. 


SOFTWARE POSTAGE: Software sent post-free to UK addresses. Abroad add £1.00 per program for postage and packing. 
SUPPLIES POSTAGE: For disks, boxes and stands, add £2.50 for postage to UK addresses, or 10% of order value (minimum postage £3.50) 
| EUROCARD 


PAYMENT:We can accept payment by cash, cheque (in UK Pounds Sterling only, drawn on UK branch of bank or building society), Postal Order, Internationa 


Postal/Money order, or Eurocheque. We can also accept payment by these credit cards: VISA, ACCESS, MASTERCARD, EUROCARD and also Barclays 
CONNECT card. Please state your card type, number, expiry date and your address (goods paid for by credit card can only be sent to cardholder's address). 







Remember to sign your order. Goods remain property of DJC until paid for in full. Our telephone number above has an answering machine for when we are 
unable to answer in person — don't be shy! 


aieceadeh tempest aaap pment see 
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